grpc-go

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

本册问题地图

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 和服务端重复执行风险。

版本快照

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

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

主调用链

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

本册目录

• 整体架构：生成代码、channel、transport 与 handler 的边界
• Server 生命周期：注册、监听、连接接入与优雅停止
• ClientConn 与连接状态机：target、idle、SubConn、退避与重连
• HTTP/2 Transport 与流控：帧读写、loopyWriter、窗口与 BDP
• RPC Stream 与重试：统一 stream 模型、编解码、提交点与透明重试
• 拦截器链：client/server unary/stream 四类扩展点
• Resolver 与 Balancer：地址、服务配置、SubConn 和 Picker
• Status、Metadata 与 Credentials：跨进程错误、上下文头和安全边界
• 面试专题：源码级高频题与排障场景

Related

• Go 源码解析
• Kratos gRPC 传输
• etcd 客户端与一致性读取