Skip to content
Max / Knowledge

grpc-go

Difficulty
Advanced
Status
Stable
Last reviewed
2026年8月

This content is not available in your language yet.

grpc-go 把生成代码暴露的 RPC 调用，落实为名字解析、负载均衡、连接状态机、HTTP/2 多路复用、流控和状态传播。本册沿着“创建 channel、选取 SubConn、建立 transport、创建 stream、收发消息、关闭连接”的主线阅读源码。

本册问题地图

Section titled “本册问题地图”

grpc-go 要把一次 RPC 拆成“名字解析、子连接选择、HTTP/2 stream、消息收发、状态返回”五段：

  1. ClientConn 为什么不是一条连接？ 它是面向逻辑目标的连接管理器，下面可以有多个 SubConn 和 transport，地址变化时无需让业务重新创建客户端。
  2. Resolver 与 Balancer 如何协作？ Resolver 提供地址和服务配置，Balancer 把地址转成可用 SubConn 并选择一次请求的 Pick 结果。
  3. 一次 RPC 为什么落到 stream？ HTTP/2 用 stream 在同一连接上多路复用请求，headers、message、status 分阶段传输。
  4. 流控影响什么？ 发送窗口和接收窗口共同限制在途数据，应用不消费或不读取会反向阻塞发送方。
  5. 重试何时危险？ 连接失败前请求可能已经到达服务端，自动重试必须结合幂等、hedging 和服务端重复执行风险。

版本快照

Section titled “版本快照”
项 值
仓库 grpc/grpc-go
本地路径 E:\source\go\grpc-go
分支 master
Commit bf9e7cd3（2026-08-14）
最近 tag v1.84.0-dev

本册源码坐标均基于该 commit；上游演进后行号可能漂移。

主调用链

Section titled “主调用链”
generated stub
    |
    v
ClientConn.Invoke / NewStream
    |
    +-> resolver -> service config -> balancer -> Picker
    +-> SubConn / addrConn -> HTTP/2 ClientTransport
    |
    v
clientStream -> HEADERS / DATA -> server transport
    |
    v
Server.handleStream -> interceptor chain -> generated handler
    |
    v
status + trailers

本册目录

Section titled “本册目录”
Section titled “Related”