Go / 系统课时

定位 goroutine 泄漏

定位 goroutine 泄漏

goroutine 数量持续上涨时,普通 goroutine profile 很难直接区分“暂时阻塞”和“已经无法唤醒”。Go 1.27 提供 goroutineleak profile,可报告运行时能够证明无法解除阻塞的 goroutine,并通过堆栈把问题收敛到具体阻塞操作和创建位置。

学习目标

  • 构造无法解除的 channel 阻塞并采集 goroutineleak profile
  • 根据泄漏堆栈定位阻塞语句和 goroutine 创建位置
  • 识别 goroutineleak 能检测与不能检测的泄漏模式

复现一个确定的泄漏

下面的 leak 创建无缓冲 channel 后启动发送 goroutine,但函数立即返回,没有任何接收者保留。发送操作会永久阻塞在 ch <- struct{}{},而这个 channel 也只剩泄漏 goroutine 自己持有。

go
package main

import (
    "log"
    "net/http"
    _ "net/http/pprof"
)

func leak() {
    ch := make(chan struct{})
    go func() {
        // 没有接收者,发送操作无法完成。
        ch <- struct{}{}
    }()
}

func main() {
    for range 5 {
        leak()
    }

    log.Println("pprof listening on 127.0.0.1:6060")
    log.Fatal(http.ListenAndServe("127.0.0.1:6060", nil))
}

预期结果:运行程序后会创建 5 个阻塞的发送 goroutine,并启动只监听回环地址的 pprof 服务。

text
<TIME> pprof listening on 127.0.0.1:6060

导入 net/http/pprof 后,默认 mux 会注册 pprof 处理器;Go 1.27 中可通过 /debug/pprof/goroutineleak 获取泄漏 profile。这里仅绑定 127.0.0.1,避免把调试端点直接暴露到外网。

采集并定位泄漏堆栈

把源码保存为 main.go,先启动示例服务:

bash
go run main.go

预期输出:

text
<TIME> pprof listening on 127.0.0.1:6060

保持服务运行,在另一个终端请求文本格式的泄漏堆栈:

bash
curl -sS 'http://127.0.0.1:6060/debug/pprof/goroutineleak?debug=2'

预期结果会出现多组同类堆栈,关键位置类似:

text
goroutine <ID> [chan send]:
main.leak.func1()
    <PATH>/main.go:<LINE> +<OFFSET>
created by main.leak in goroutine 1
    <PATH>/main.go:<LINE> +<OFFSET>

[chan send] 表明 goroutine 阻塞在 channel 发送,main.leak.func1 指向实际阻塞函数,created by main.leak 则给出创建位置。如果同类堆栈数量持续增加,应继续追查调用 leak 的上游路径。<ID>、<PATH>、<LINE> 和 <OFFSET> 会随构建与运行环境变化。

goroutineleak 的可达性判定机制

修复并重新验证

这个最小例子可以通过让发送操作具备可完成路径来消除泄漏。例如,增加足够缓冲能让这里唯一一次发送立即完成,但在真实服务中,更可靠的做法通常是让生产者同时监听 context.Context 的取消信号,使消费者提前退出时生产者也能结束。

修复后再次请求同一个 goroutineleak 端点。预期结果是原先指向 main.leak.func1 的泄漏堆栈消失;如果仍存在同类记录,应继续检查是否还有其他创建路径或同步原语处于不可解除的阻塞状态。

认识检测边界

goroutineleak 依赖运行时的可达性分析,因此不能发现所有“业务上已经没用”的 goroutine。它更擅长识别永久阻塞在 channel 或部分 sync 同步原语上,并且运行时能够证明相关同步对象无法再被可运行 goroutine 触达的情况。

如果阻塞对象仍由全局变量或可运行 goroutine 的局部变量持有,运行时可能无法证明它永远不会被唤醒。网络 I/O 长时间卡住、逻辑循环不退出或等待仍可能被外部事件解除的 goroutine,也不能只靠这个 profile 判定,应结合普通 goroutine profile、超时、上下文取消和业务指标继续诊断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位 goroutine 泄漏

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通