Go goroutine 泄漏导致内存持续增长怎么排查？

Question

仓乃文 · Accepted Answer

goroutine 泄漏是最常见的 Go 内存泄漏形式。goroutine 本身只占几 KB 栈空间，但它持有的变量、channel 引用、闭包捕获的对象都无法被 GC 回收，泄漏几百个 goroutine 就可能占用大量内存。

常见泄漏原因：
- channel 未关闭，接收方永久阻塞
- nil channel 上的发送/接收永久阻塞
- context 未 cancel，goroutine 永远等不到退出信号
- WaitGroup 计数不匹配，Wait 永远不返回

排查步骤：
```go
// 1. 引入 pprof
import _ "net/http/pprof"
// 访问 http://localhost:6060/debug/pprof/goroutine?debug=1
// 查看所有 goroutine 的调用栈，找出阻塞的

// 2. 命令行分析
go tool pprof http://localhost:6060/debug/pprof/goroutine
// (pprof) top    -- 看 goroutine 数量分布
// (pprof) traces -- 看完整调用栈

// 3. 对比两个时间点的 goroutine 数量
// 如果持续增长，一定有泄漏
```

用 leaktest 在测试中自动检测：
```go
import "github.com/fortytw2/leaktest"

func TestNoLeak(t *testing.T) {
    defer leaktest.Check(t)() // 测试结束后检查 goroutine 数量
    // ... 业务逻辑
}
```

补充说明：
- runtime.NumGoroutine() 可在代码中实时获取 goroutine 数量，接入监控告警
- go run -race 能检测数据竞争，但不能检测 goroutine 泄漏
- 生产环境务必接入 pprof，goroutine 泄漏往往在运行数小时后才显现
- 预防原则：每个 goroutine 都要有明确的退出条件