grpc 默认基于 http/2 实现长连接,无需开启;关键在于配置 keepalive 防止意外断连:服务端需设 maxconnectionidle、time、timeout 并启用 permitwithoutstream,客户端须复用 clientconn 且配 withkeepaliveparams,同时确保 nginx/envoy 等代理 keepalive_timeout 同步。

Go 语言微服务中,gRPC 默认就是长连接,不需要“开启”长连接——它基于 HTTP/2,连接复用是协议原生行为。真正要动手的,是防止连接被意外关闭、控制生命周期、以及让客户端和服务端对 keepalive 的理解一致。
grpc.NewServer 必须显式配置 Keepalive 参数
服务端不配 keepalive,连接空闲几分钟后就会被静默断开,客户端下次调用直接报 rpc error: code = Unavailable desc = transport is closing。这不是 bug,是 HTTP/2 的默认行为。
-
MaxConnectionIdle是关键:设为30 * time.Minute表示空闲超时关闭,设为0则禁用,但不推荐(可能堆积无效连接) -
Time和Timeout控制 ping 帧频率和等待响应时间,建议设为10 * time.Second和3 * time.Second - 如果前面有 Nginx / Envoy,必须同步设置其
keepalive_timeout,否则服务端发的 ping 会被代理截断
客户端必须复用 *grpc.ClientConn 实例
每次调用都 grpc.Dial() 一次,等于每请求建一个 TCP 连接,netstat 里全是 TIME_WAIT,QPS 上不去,还容易触发端口耗尽。
- 全局或单例复用
*grpc.ClientConn,并在程序退出前调用conn.Close() - 不要在 handler 里临时 Dial;若需多服务实例,按服务名缓存 Conn,而不是按请求新建
- 启用
grpc.WithKeepaliveParams让客户端也主动发 ping,避免中间设备(如防火墙)单向断连
protoc 生成代码必须同时用 --go_out 和 --go-grpc_out
写成 protoc --grpc_out=. 会报错 unrecognized option '--grpc_out',因为老插件已废弃。新版本严格分离职责:
-
--go_out=.:只生成*.pb.go(数据结构) -
--go-grpc_out=.:生成*_grpc.pb.go(服务接口、RegisterXXXServer、NewXXXClient) - 缺一不可;且确保
protoc-gen-go-grpc在$PATH中,版本 ≥ v1.60
PermitWithoutStream 开关影响连接保活行为
gRPC 默认要求有活跃 stream 才允许 keepalive ping 发送。如果服务全是 unary RPC(无流),且没开这个开关,服务端 ping 可能被忽略,导致连接提前断开。
- 服务端加
grpc.KeepaliveEnforcementPolicy(keepalive.EnforcementPolicy{PermitWithoutStream: true}) - 该参数在高延迟网络或纯 unary 场景下几乎必开,否则 keepalive 形同虚设
- 注意它不改变 client 端行为,只放宽 server 端对 ping 帧的接收条件
真正容易被忽略的不是“怎么配”,而是两端 keepalive 参数的语义差异和中间设备的存在——服务端设了 idle 超时,客户端没配 ping,或者 Nginx timeout 比 gRPC 小 1 秒,都会导致连接在某个环节无声断开。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











