仅导入"net/http/pprof"不足以排查内存泄漏，必须显式启动http服务、用?gc=1&inuse_space=1采集堆快照、通过-base比对两次采样，并结合goroutine分析定位泄漏源头。
只加 import _ "net/http/pprof" 不足以排查内存泄漏——它只是注册了 HTTP handler，不触发 GC、不指定指标、不保证采样干净，直接访问 /debug/pprof/heap 得到的往往是干扰项。
必须手动启用并验证 pprof HTTP 端点
pprof 默认不监听任何端口，import _ "net/http/pprof" 仅注册路由，不启动服务。漏掉这一步，后续所有采样都无效。
- 在
main()中显式启动 HTTP server：go http.ListenAndServe("localhost:6060", nil)（生产环境建议绑定127.0.0.1或加认证） - 用
curl -s http://localhost:6060/debug/pprof/ | head -20确认返回 HTML 列表，而非 404 或 connection refused - 若用 Gin 等框架，需调用
pprof.Register(router)而非仅导入包；Echo 用户要手动router.GET("/debug/pprof/*pprof", echo.WrapHandler(http.DefaultServeMux))
抓 heap profile 必须带 ?gc=1&inuse_space=1
默认 /debug/pprof/heap 返回的是瞬时快照，含大量待回收垃圾，inuse_space 才反映真实存活对象。不加 ?gc=1，runtime 不会主动执行 GC，堆里堆着刚分配但即将被丢弃的对象，导致误判。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 正确采集命令：
curl -s "http://localhost:6060/debug/pprof/heap?gc=1&inuse_space=1" > heap1.pb.gz - 禁止用
?allocs判断泄漏：它统计历史总分配量，GC 后归零，高值只说明频繁分配，不是泄漏 - 两次采样间隔至少 2 分钟：太短 GC 没跑完，数据不可比；太长可能混入业务波动
比对差异必须用 -base，不能只看单次 top
go tool pprof http://... 默认只加载单个 profile，显示的是绝对占用，看不出增长来源。内存泄漏必须靠「差分」定位净新增部分。
- 基准快照先存：
curl -s "http://localhost:6060/debug/pprof/heap?gc=1&inuse_space=1" > heap0.pb.gz - 运行一段时间后再采：
curl -s "http://localhost:6060/debug/pprof/heap?gc=1&inuse_space=1" > heap1.pb.gz - 比对命令：
go tool pprof -base heap0.pb.gz heap1.pb.gz，交互中输入top -cum查净增长最多的调用栈 - 若
top里全是runtime.mallocgc或bytes.makeSlice，说明没过滤临时分配——回退重采，别信火焰图
goroutine 泄漏常是内存泄漏的真正源头
很多情况下 heap profile 看不出明显增长，但内存持续上涨、runtime.NumGoroutine() 却一路飙升——这是因为 goroutine “钉住”了大对象（如闭包捕获 []byte、channel 接收者挂起 map 引用），GC 不敢回收。
- 查完整 goroutine 栈：
curl -s "http://localhost:6060/debug/pprof/goroutine?debug=2" > goroutines.txt（注意是?debug=2，?debug=1只给统计） - 重点搜阻塞态关键词：
chan receive、select、time.Sleep、http.Transport.RoundTrip - 若发现某业务文件行号（如
client.go:72）反复出现在数百个 goroutine 栈底，大概率是未关闭 channel 或无超时 HTTP client
真正难的是区分「长生命周期缓存」和「泄漏」：前者 inuse_space 稳定在高位，后者持续线性上涨；而 cgo 分配、unsafe.Pointer 持有、timer/netpoll 底层结构，pprof 根本看不见——这些地方得换 valgrind 或 GODEBUG=cgocheck=2 配合查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
