典型现象是服务端send()第三次阻塞或客户端recv()返回transport is closing；根本原因是流生命周期管理不当，需检查每次send()/recv()错误、避免proto实例复用、确认stream关键字位置正确、配置消息大小与http/2窗口参数，并用context.done()控制goroutine退出。
gRPC流式传输卡住的典型现象和定位方式
服务端 stream.Send() 第三次就阻塞，或客户端 stream.Recv() 突然返回 rpc error: code = Unavailable desc = transport is closing，基本不是网络问题，而是流生命周期没管好。
先确认错误是否被忽略：每次 stream.Send() 或 stream.Recv() 后必须检查返回 error，否则后续调用会静默失败；io.EOF 是正常结束信号，不是错误，不能 panic 或直接退出 goroutine。
- 用
stream.Context().Err()检查上下文状态，客户端断连、超时、取消都会触发它 - 服务端流场景下，别在 for 循环里反复复用同一个
*pb.Response实例——proto 序列化会覆盖内部 buffer，导致客户端收到空数据或乱码 - 启动一个独立 HTTP 服务（如
:10001）并导入net/http/pprof，用go tool pprof http://localhost:10001/debug/pprof/goroutine?debug=2查看堆积的 stream goroutine，确认是否泄漏
proto 定义错一个字，生成的 Go 接口就完全不可用
流类型由 .proto 中 stream 关键字的位置严格决定，不是靠注释或命名习惯判断：
-
rpc SubscribeLogs(LogRequest) returns (stream LogEntry)→ 服务端流（Server Streaming） -
rpc Upload(stream Chunk) returns (UploadResult)→ 客户端流（Client Streaming） -
rpc Sync(stream FileChunk) returns (stream SyncAck)→ 双向流（Bidirectional Streaming）
常见错误是把 stream 加在请求侧却当成服务端流用，比如写成 rpc Get(stream Req) returns (Resp)，结果生成的是客户端流接口，stream.Recv() 被调用方误当 Send() 用，编译能过但运行时永远收不到数据。
大文件流式传输必调的三个连接参数
默认 gRPC 消息大小限制是 4MB，传大文件不改参数必然报 grpc: received message larger than max。这三处必须显式配置：
- 服务端初始化时加
grpc.MaxRecvMsgSize(64 * 1024 * 1024)和grpc.MaxSendMsgSize(64 * 1024 * 1024) - 客户端
grpc.Dial()也要配同样大小的grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(...), grpc.MaxCallSendMsgSize(...)) - HTTP/2 层流量控制：用
grpc.InitialWindowSize(64 * 1024 * 1024)和grpc.InitialConnWindowSize(64 * 1024 * 1024)避免小窗口导致频繁等待 ACK
注意：这些值不是越大越好，要结合内存压力评估；容器环境尤其要防 OOM，64MB 是较稳妥的起点。
双向流中 goroutine 泄漏的隐蔽来源
双向流最易出问题的地方，是忘记用 select + context.Done() 控制循环退出，导致 goroutine 永久挂起：
错误写法：for { stream.RecvMsg(&msg) } —— 一次 RecvMsg() 卡住，整个 goroutine 就死了，且无法被 GC 回收。
正确做法是始终配合超时和 cancel：
- 服务端收发都走
select，分支包含case - 客户端启动两个 goroutine 分别处理收/发，各自用
defer stream.CloseSend()或defer stream.CloseRecv()显式释放 - 别依赖
defer包裹整个流处理函数——如果流没结束，defer 不触发
真正难排查的是“看起来正常跑着，但内存持续上涨”，这时大概率是流没关、goroutine 堆积、proto 实例没释放。这类问题不会立刻报错，但压测半小时后就暴露。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
