真正内存泄漏需同时满足HeapInuse持续单向增长且pprof中某类对象inuse_space线性上升;抓取有效heap profile须满足三条件:文件名含.heap或.pb.gz后缀、禁用?gc=1、两次采样间隔≥30秒且程序已稳定。

不是“内存涨了就是泄漏”,真泄漏必须同时满足两个条件:runtime.MemStats.HeapInuse 在稳定负载下持续单向增长,且 pprof 的 inuse_space 中某类对象(如 *http.Request、[]byte)随时间线性上升;其他情况大概率是 GC 滞后、缓存预热或临时分配未回收。
怎么抓到真正能定位泄漏的 heap profile
线上或本地复现时,快照无效的主因是采样方式错误。必须同时满足三个硬条件,缺一不可:
- 文件名必须带
.heap或.pb.gz后缀(例如before.heap),否则go tool pprof会报 “unrecognized profile format” - 绝对不要加
?gc=1参数——它强制 GC 后采样,会把本该长期存活的对象“刷掉”,profile 里只剩临时垃圾,完全掩盖泄漏点 - 两次采样间隔 ≥30 秒,且程序已稳定运行(刚启动、
MemStats.NextGC接近HeapAlloc时采样,快照里全是待 sweep 的对象,数据失真)
推荐操作:服务启动并稳定 5 分钟后,执行 wget http://localhost:6060/debug/pprof/heap -O before.heap,等 30 秒再执行 wget http://localhost:6060/debug/pprof/heap -O after.heap。
用 pprof 差分分析 inuse_space 的关键操作
单看一次 top 列表几乎找不到泄漏源,因为泄漏对象在总驻留内存中占比往往极小。必须做差分比对:
立即学习“go语言免费学习笔记(深入)”;
- 运行
go tool pprof -http=:8080 -base before.heap after.heap - 浏览器打开后,顶部 SAMPLE 下拉菜单切到
inuse_space(不是alloc_space或alloc_objects) - 点击 View → Difference(不是 Top 或 Flame Graph),只有差分才能看到「净增长」部分
- 在搜索框输入可疑类型,比如
*UserConfig或model.Order,再点 Call graph,重点盯调用链里夹着(*ConnPool).reaper、timerproc、connectionOpener的路径——它们往往是泄漏入口
为什么 goroutine 泄漏常被误判为内存泄漏
90% 的“内存缓慢上涨”实际是 goroutine 没退出,死死钉住一堆堆对象。每个 goroutine 默认栈 2KB,但更危险的是它闭包捕获的 []byte、map、channel 或 context.Value。
- 用
curl "http://localhost:6060/debug/pprof/goroutine?debug=2"查全量栈,重点关注状态为chan receive、select、semacquire的长期阻塞 goroutine - 检查代码中是否漏掉
time.Ticker.Stop()、http.CloseNotifier未取消、json.Unmarshal后把指针塞进全局sync.Map却永不删除 -
runtime.NumGoroutine()打点监控比内存指标更早暴露问题——goroutine 数持续上升,往往比 HeapInuse 上涨早 2–3 分钟
最易被忽略的一点:泄漏对象未必是你代码里显式 &T{} 创建的,而更可能是通过 json.Unmarshal、database/sql 查询结果或中间件 context.WithValue 间接持久化进全局结构体的指针。Focus 搜索时别只盯着自己写的函数名,要顺着调用链往 runtime 和第三方库深处看。


















