Go协程(Goroutine)泄漏会让内存持续攀升,最终拖垮整个服务。根据排查实践,绝大多数协程泄漏都源于阻塞操作没有超时控制、退出信号未传递或锁使用不当,而通过 runtime/pprof 采集协程栈快照,再配合 go tool trace 分析调度事件,就能在分钟级内定位泄漏源头。
本文先梳理典型泄漏场景,再给出基于 pprof 和 trace 的具体排查方法,最后总结一些设计期的预防手段。希望能帮你在高并发服务中快速止血。
协程泄漏的本质是协程进入永久阻塞态,既无法执行完退出,也不再被调度器唤醒。常见的触发场景有以下三类:
为了演示,这里给出一个典型的泄漏代码:
package main
import (
"fmt"
"net/http"
_ "net/http/pprof"
"sync"
)
func leak() {
ch := make(chan int)
// 协程读 channel,但永远不会有人写入
go func() {
<-ch
}()
}
func main() {
go func() {
http.ListenAndServe("localhost:6060", nil)
}()
var wg sync.WaitGroup
for i := 0; i < 1000; i++ {
wg.Add(1)
go func() {
defer wg.Done()
leak()
}()
}
wg.Wait()
fmt.Println("done")
}这段代码中每个 leak() 都会创建一个读 channel 的协程,由于没有写入方,协程永不会退出。运行程序后,协程数量会随时间线性增长。
使用 runtime/pprof 的 Goroutine profile 是定位协程泄漏最直接的手段。通过 net/http/pprof 暴露的 /debug/pprof/goroutine 接口,可以获取所有协程的栈信息和数量统计。
启动程序后,执行 curl 命令抓取 profile:
curl http://localhost:6060/debug/pprof/goroutine?debug=1 -o goroutine.txt
然后查看输出文件,重点观察数量增长最异常的栈。例如上面的泄漏代码,栈会停留在 channel receive 处:
goroutine profile: total 1002 1000 @ 0x100f6c5 0x100e8c8 0x1007f90 0x10076c5 # 0x1007f90 main.leak.func1+0x30 ... # main.leak.func1() # goroutine.go:8 +0x30
核心观察点是栈底函数中是否存在 chan receive、sync.Mutex.Lock、net.Conn.Read 等阻塞类调用。若同一位置的协程数量从一开始就持续增长,基本可以确认泄漏源。
若需要更细粒度的状态,可以用 go tool pprof 分析二进制格式的 profile。抓取命令:
curl http://localhost:6060/debug/pprof/goroutine -o goroutine.prof go tool pprof -http=:8080 goroutine.prof
在浏览器中可以看到可视化调用图,以及每个协程的当前状态(运行、阻塞、系统调用等)。
不同方式的适用场景和精度存在差异,对比如下:
| 工具 | 数据来源 | 适用场景 | 定位精度 |
|---|---|---|---|
| http/pprof | runtime.Stack 快照 | 瞬时协程数量分析 | 函数级定位 |
| go tool pprof | profile 文件 | 分布趋势与调用关系 | 调用图 + 数量 |
| go tool trace | 调度事件流 | 协程生命周期与阻塞原因 | 事件级定位 |
据 Google 工程师 Dmitry Vyukov 在 GopherCon 上的分享,Go 运行时的 trace 数据能展示四类阻塞事件:网络、锁、系统调用、channel。利用这些事件可以区分协程是等待 I/O 还是等待锁,从而进一步缩小范围。
go tool trace 能把协程的创建、阻塞、唤醒和调度切换完整记录下来,为定位泄漏提供比 pprof 更动态的证据。首先在程序中启动 trace 输出,然后运行负载复现问题:
import (
"os"
"runtime/trace"
)
func main() {
f, _ := os.Create("trace.out")
trace.Start(f)
defer trace.Stop()
// … 运行你的业务逻辑 …
}之后用命令打开 trace 文件:
go tool trace trace.out浏览器界面中,选择 “View trace” 或 “Goroutine analysis”,可以清晰看到每个协程的时间线。若某个协程的 G 段呈一条平直长线,期间没有任何调度事件,说明它正无限期阻塞。
在 “Proc” 视图中,还能看到 CPU 核上的调度空隙。如果大量协程都停在 chan receive 且处理器空闲,就证明协程没有被正确唤醒。此时回到源码,检查写入 channel 的地方是否真的执行了,以及是否需要加超时或 select 默认分支。
另一个实用技巧是打印创建协程时的调用栈。通过 runtime.Stack 在协程入口上报标识,结合 trace 中的 goroutine id,可以对应到具体业务代码。
防泄漏比排查更重要,核心思路是给每个协程设定明确的生命周期边界。以下四条策略能显著降低泄漏概率:
以监听停止信号为例,正确做法是:
func worker(ctx context.Context) {
for {
select {
case <-ctx.Done():
return
default:
// 处理业务
}
}
}这条代码的关键在于 select 同时关注上下文取消和业务处理,避免出现死循环或永久阻塞。
Go协程泄漏不是偶发问题,它会在流量高峰时集中爆发。每次发布前,建议在压测环境中抓一次 pprof 的协程基线,与上线后对比数量变化。如果协程数持续增加且迟迟不回落,就说明存在泄漏。从我的实际经验看,百分之八十的泄漏都能在五分钟内通过 pprof 栈信息直接锁定。
最后提醒一点:Goroutine 本身只占几 KB 内存,但泄漏的协程会叠加持有栈、channel、锁等资源,最终使 GC 压力和内存占用同时飙升。所以排查时不要只看内存总量,优先对比协程数量才是最有效的信号。
评论
加载中...