直接看 runtime.NumGoroutine() 和 /debug/pprof/goroutine?debug=2:前者监控压测后是否回落,后者通过完整堆栈定位 chan receive、io.ReadFull 等阻塞点;常见泄漏源于 HTTP client 未读响应体、middleware 未监听 ctx.Done()、time.Ticker 未 stop、gRPC 流未 close。

直接看 runtime.NumGoroutine() 和 /debug/pprof/goroutine?debug=2,别依赖日志或中间件埋点——这是 Kratos 服务协程状态最真实、最不可绕过的两个观测入口。
怎么在 Kratos 里暴露实时协程数
Kratos 默认已启用 net/http/pprof,只要 HTTP server 跑着,/debug/pprof/goroutine 就可用。但生产环境通常不暴露完整堆栈,所以建议在健康检查接口(如 /healthz)里主动打点:
- 在 health handler 中调用
runtime.NumGoroutine(),返回当前值(比如{"goroutines": 87}) - 避免只采一次:压测中每秒打点 + 记录时间戳,观察“请求结束→数值回落”是否稳定
- 注意空闲态基线:刚启动时 60–90 是正常范围(pprof、etcd watch、prometheus collector 等都在后台跑)
- 别用
log.Printf频繁输出——日志 I/O 本身会干扰 goroutine 调度,造成误判
为什么必须用 ?debug=2 查泄漏
?debug=1 只返回 goroutine 总数和按状态分类的粗略统计,完全看不出谁卡在哪;?debug=2 才输出完整调用栈和阻塞时长,是线上唯一能定位根因的手段:
- 重点关注堆栈中出现
chan receive、select、io.ReadFull、net.Conn.Read的 goroutine - 阻塞时间显示
432000s(5 天)或更大值,基本可断定是泄漏,不是临时等待 - 若大量 goroutine 卡在同一个函数(比如
http.(*persistConn).readLoop),大概率是 HTTP client 响应体没读完或没关闭 - Kratos 的 middleware 或 transport 层不会自动帮你 stop goroutine,所有阻塞点都来自你写的代码或第三方 client
常见泄漏点在 Kratos 哪些位置
Kratos 本身不创建长期 goroutine,但它的使用模式让某些泄漏特别高频:
-
HTTP client调用后只取resp.StatusCode就扔掉resp:底层连接池无法复用,readLoop/writeLoopgoroutine 悬停 - middleware 中起 goroutine 做异步日志或 metric 上报,但没监听
ctx.Done():请求已结束,goroutine 还在等 channel 或 sleep - 用
time.Ticker做心跳或清理,但没在app.Stop()阶段显式调用ticker.Stop() - gRPC 流式调用未 close:
stream.SendMsg()后漏掉stream.CloseSend(),或stream.Recv()循环里没处理io.EOF就 break
单元测试里怎么提前发现协程泄漏
用 goleak.VerifyTestMain,不是 goleak.VerifyNone——微服务测试中后台 goroutine(如 etcd watch、HTTP server、ticker)跨测试生命周期存在,单个 test 的快照容易漏检:
- 在
TestMain中包裹整个测试生命周期:os.Exit(goleak.VerifyTestMain(m)) - 所有后台资源(
http.Server、time.Ticker、client monitor loop)必须在TestMain返回前显式Shutdown或Stop - 忽略框架协程时,
goleak.IgnoreTopFunction必须填完整函数签名,例如:"github.com/coreos/etcd/clientv3.(*watchGrpcStream).serveWatchClient",子串匹配无效 - 测试里启了合法后台 server(如 mock gRPC),得加
goleak.IgnoreCurrent(),否则误报
协程状态监控不是“加个 metrics 就完事”,关键在三个动作是否闭环:压测后数值回落、?debug=2 里看不到超长阻塞、测试终局检查无残留。Kratos 把可观测性入口收得很集中,但不会替你决定哪些 goroutine 该活、哪些该死——那部分逻辑,始终在你写的 Do、Recv、select 和 close 里。











