Go goroutine 泄漏排查：Context 取消、阻塞栈与泄漏定位

goroutine 数量持续上涨通常意味着某些协程没有退出。常见原因包括 context 未取消、channel 阻塞、ticker 未停止、HTTP Body 未关闭和 worker 队列无限堆积。

解决方案思路

所有长生命周期 goroutine 都要有退出条件；外部请求派生的 goroutine 必须监听 ctx.Done；定时器和 ticker 要 Stop。线上先看 goroutine 指标，再用 pprof dump 按阻塞栈聚合。

核心代码示例

func worker(ctx context.Context, jobs 

运行逻辑

goroutine 指标触发告警后，抓取 dump 并按堆栈分组。若大量 goroutine 卡在同一个 channel receive、HTTP read 或锁等待，就能回到对应代码修复退出条件。

重点观察指标

• goroutine 总数和增长斜率
• pprof goroutine dump 相同栈数量
• 队列长度、ticker 数量和下游连接等待

常见误区

• 启动 goroutine 时没有绑定生命周期
• for-select 没有 ctx.Done 分支
• 只重启服务，不修复泄漏源

参考方案

• context 官方文档
• net/http/pprof 官方文档

落地检查

• 字段、指标和 Span 名称要稳定，便于长期聚合。
• 上线前先在灰度环境验证采集成本和数据量。
• 告警必须能指向 owner、排查入口和回滚方案。