goroutine-leak

Go goroutine 泄漏

现象

Go 服务内存和 goroutine 数持续增长，最终 OOM 或调度变慢；/debug/pprof/goroutine 显示大量相同调用栈的 goroutine 阻塞在 channel、锁或网络读写。

快速定位

curl -s http://localhost:6060/debug/pprof/goroutine?debug=1 | head -50
curl -s http://localhost:6060/debug/pprof/goroutine?debug=2 > goroutines.txt
go tool pprof http://localhost:6060/debug/pprof/goroutine

查看 goroutine 数和内存：

curl -s http://localhost:6060/debug/pprof/ | grep goroutine
go tool pprof -top http://localhost:6060/debug/pprof/heap

常见根因

• channel 发送/接收没有退出路径，goroutine 永久阻塞。
• HTTP 请求没有设置超时，连接和 goroutine 堆积。
• context 没有取消，后台任务一直运行。
• 循环里启动 goroutine 但没有 WaitGroup 或限流。
• 锁竞争或死锁导致 goroutine 卡住。
• 第三方库启动的后台 goroutine 没有关闭。

修复

• 所有阻塞操作都要有 context 超时或取消。
• channel 关闭和退出信号要成对设计。
• 用 errgroup 或 WaitGroup 管理生命周期。
• 限制并发数，使用 worker pool。
• 给 HTTP client 设置 Timeout 和 Transport 超时。
• 修复后对比 goroutine 曲线，确认不再增长。

相关命令

• go tool pprof — goroutine/heap/CPU 分析
• curl — 访问 pprof 端点
• go-torch / pprof — 火焰图
• netstat / ss — 连接堆积排查