协程泄漏是 runtime.NumGoroutine() 持续单向上涨且 pprof debug=2 显示大量 goroutine 卡在 chan receive/select/semacquire；需排除初始化波动，重点监控请求后不回落、压测后不恢复、长期单调上升三种趋势，并结合三处日志、pprof 快照对比及 goleak 测试拦截定位修复。
协程泄漏不是“可能有”，而是 runtime.NumGoroutine() 持续单向上涨 + pprof 里一堆卡在 chan receive、select 或 semacquire 的 goroutine —— 这就是铁证。
用 runtime.NumGoroutine() 快速筛出真泄漏
数字高不等于泄漏，刚启动时跳到 100+ 很正常，那是 pprof、健康检查、日志采集等后台 goroutine 在初始化。关键看趋势：
- 单次 HTTP 请求入口打点是 85，handler 返回前再打一次还是 85+，说明没回落
- 压测结束等待 30 秒后，总数仍比空闲态（比如 60）高出 40 以上
- 服务稳定运行几小时，从 50 → 180 → 420 这样单调爬升
实操建议：在关键路径加三处日志，别只采一次：log.Printf("goroutines@idle: %d", runtime.NumGoroutine())、@start、@done。采样要间隔足够久（比如 time.Sleep(100 * time.Millisecond)），否则漏掉靠超时退出的协程。
用 /debug/pprof/goroutine?debug=2 定位阻塞点
默认 ?debug=1 只给统计摘要，看不出谁卡在哪；必须加 ?debug=2 才输出完整调用栈和阻塞时长。生产环境直接 curl http://localhost:6060/debug/pprof/goroutine?debug=2 就行。
重点关注这些状态的 goroutine：
-
chan receive (nil chan)：监听了未初始化或已关闭的 channel -
select卡死：所有 case 都不可达，且没写default -
semacquire：锁没释放、sync.WaitGroup忘记Done() -
IO wait：比如io.ReadFull卡住、ssh.Dial没设超时、http.Client没配context
如果看到几百个 goroutine 全卡在同一个函数里，阻塞时间显示 “432000s”（5 天），基本不用怀疑，就是它。
用 goleak.VerifyNone(t) 在测试阶段拦截泄漏
pprof 是事后诊断，goleak 是事前拦截。它靠比对测试前后 goroutine 快照，报告“新增但未退出”的协程及其初始调用栈。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
常见误用和坑：
- 必须写成
defer goleak.VerifyNone(t)，否则 test panic 时不会执行 - 别在
defer后又立刻return，否则 verify 执行时 goroutine 已退出，漏检 - 若测试里合法启了 HTTP server 或 ticker，得提前调用
goleak.IgnoreCurrent()，否则误报 - 它不检测“缓慢泄漏”，只抓测试生命周期内未退出的 goroutine
更稳的做法是用 goleak.VerifyTestMain(m) 包裹整个 TestMain，覆盖所有测试用例。
修复核心：谁启的 goroutine，谁负责它能退出
90% 的泄漏来自 channel 和 context 使用不当。三个硬约束必须守住：
- 向
nil chan发送或接收 → 永久阻塞，runtime不 panic，goroutine 直接挂住 - for range channel 死等，却忘了
close(ch) - 写
go func() { ... }()却没传context.Context，也没监听ctx.Done()
正确姿势是：用 select 替代裸写 channel 操作，永远搭配 ctx.Done()；用 context.WithTimeout 或 context.WithCancel 创建子 context，并确保 cancel 被调用 —— 忘记调用，等于没加。
最易被忽略的一点：http.Response.Body 忘记 Close()，会钉住底层 persistConn，导致 readLoop/writeLoop goroutine 残留。这不是可选操作，是退出链上关键一环。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
