如何在Golang项目中集成Goleak作为单元测试内存泄露排查器-Golang-PHP中文网

goleak仅检测goroutine泄漏而非内存泄漏，需defer verifynone(t)在每个测试函数末尾显式调用，配合ignorecurrent()忽略手动启动的后台协程，并聚焦channel生命周期管理——90%泄漏源于channel未关闭或误操作。

如何在golang项目中集成goleak作为单元测试内存泄露排查器

goleak 不是内存泄露排查器，它只检测 goroutine 泄漏——而 goroutine 泄漏本身会导致内存间接上涨（比如协程持有了大对象），但它不检查 heap、allocs 或对象生命周期。别把它当 pprof heap 用，也别指望它报出“内存没释放”。

它不会自动生效，也不会继承到子测试。没 defer 就等于没加；放在函数中间或开头，panic 或提前 return 时就跳过了。

defer goleak.VerifyNone(t) 要紧贴函数末尾写（哪怕只是占一行），确保所有路径（包括 panic、t.Fatal、t.Skip）都能触发检查
用了 t.Run() 子测试？每个子测试函数体内都要单独加 defer goleak.VerifyNone(t)，父测试里的不传递
如果测试逻辑里启动了后台 goroutine（比如 go http.ListenAndServe(...)），不忽略就会被当成泄漏——得配合 goleak.IgnoreCurrent()

goleak 默认只忽略标准库内部启动的 goroutine（如 net/http 的监听协程），你代码里 go srv.Serve(lis) 或 time.NewTicker() 启的，它全算“新增泄漏”。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

最稳妥的写法是：在子测试开头调用 defer goleak.IgnoreCurrent()，拍下当前 goroutine 快照，后续新增才纳入比对
避免用 goleak.IgnoreTopFunction("myapp.(*Server).Start") —— 编译器内联、栈帧抖动会让这个匹配失效，基本白配
第三方库（比如某 SDK 启了监控 goroutine）要忽略，得用完整包路径 + 函数名，例如 goleak.IgnoreTopFunction("github.com/some/pkg.startMonitor")

goleak 报错堆栈常停在 runtime.selectgo 或 runtime.gopark，但根因几乎都是 channel 没关、或关得太早、或 nil channel 被 close。

谁创建 chan，谁负责 close()；向已 close 的 chan 发送会 panic，但接收还能读缓冲区 + 零值，容易让人误以为“还在工作”
for range ch 的 goroutine 必须等发送方 close(ch) 才退出；若发送方不确定结束时机，改用 select { case
别对 nil channel 执行 close()，也别重复 close()，两者都直接 panic

goleak.VerifyNone(t) 本身不带超时，但测试里若有未终止的 goroutine（比如卡在 time.Sleep(1 * time.Hour)），整个 go test 会卡死，CI 流水线直接超时失败。

测试末尾加 time.Sleep(10 * time.Millisecond) 不可靠——得确保待测逻辑真正结束，比如显式调用 srv.Close()、ticker.Stop()、close(done)
CI 环境建议统一用 goleak.VerifyTestMain(m) 包裹 TestMain，但前提是所有后台 goroutine 都有明确 Stop 接口并被调用
线上或集成环境无法用 goleak？那就靠 pprof：启动时导入 _ "net/http/pprof"，访问 http://localhost:6060/debug/pprof/goroutine?debug=2，重点看堆栈末尾卡在 chan receive、semacquire、selectgo 的长期 goroutine