在Golang程序开发中，内存泄漏是常见的问题之一，会导致程序运行一段时间后内存占用不断升高，最终可能引发OOM错误。pprof是Golang官方提供的性能分析工具，支持对内存、CPU、goroutine等多个维度进行采集分析，其中heap profile就是专门用于分析内存分配和泄漏的核心功能。
pprof的集成方式
如果是Web服务类程序，只需要在代码中导入net/http/pprof包，就会自动注册相关的pprof路由，无需额外编写注册逻辑。如果是普通的非Web程序，也可以手动启动一个HTTP服务来暴露pprof接口。
以下是Web服务集成pprof的示例代码：
package main
import (
"net/http"
_ "net/http/pprof" // 自动注册pprof路由
)
func main() {
// 启动HTTP服务，默认会在/debug/pprof/路径下暴露pprof接口
http.ListenAndServe("127.0.0.1:6060", nil)
}采集内存快照数据
程序运行后，可以通过两种方式获取内存快照：一种是通过浏览器访问http://127.0.0.1:6060/debug/pprof/heap直接查看当前内存分配概况；另一种是通过go tool pprof命令行工具拉取快照到本地进行分析，后者支持更丰富的分析功能。
使用命令行拉取快照的命令如下：
# 拉取当前堆内存快照到本地，保存为heap_profile文件 go tool pprof http://127.0.0.1:6060/debug/pprof/heap
分析内存泄漏的关键指标
进入pprof交互模式后，可以通过多个命令查看内存分配情况，常用的分析命令如下：
- top：查看内存分配最多的前N个函数，默认显示前10个，可以加数字指定数量，比如
top 20显示前20个。 - list 函数名：查看指定函数的内存分配细节，会显示函数内每一行代码的内存分配情况。
- web：生成内存分配的调用关系图，需要本地安装graphviz工具才能正常使用。
需要重点关注两个内存指标：alloc_space表示程序启动以来总共分配的内存空间，inuse_space表示当前仍然被占用的内存空间。如果某个函数的inuse_space持续升高，且不会下降，就说明这里可能存在内存泄漏。
常见内存泄漏场景与排查
场景1：全局切片或map未清理
如果程序中存在全局的切片或者map，不断往里面追加数据却没有清理逻辑，就会导致内存持续增长。比如下面的示例代码：
package main
import (
"net/http"
_ "net/http/pprof"
"time"
)
// 全局map，不断写入数据不清理
var globalMap = make(map[int][]byte)
func writeData() {
for i := 0; ; i++ {
// 每次写入1KB的数据，永远不删除
globalMap[i] = make([]byte, 1024)
time.Sleep(time.Millisecond * 10)
}
}
func main() {
go writeData()
http.ListenAndServe("127.0.0.1:6060", nil)
}运行这段程序后，通过pprof的top命令会看到writeData函数的inuse_space持续增长，使用list writeData命令可以看到globalMap[i] = make([]byte, 1024)这行代码的内存分配占比极高，从而定位到泄漏点。
场景2：goroutine泄漏
如果goroutine因为阻塞无法退出，且不断创建新的goroutine，也会导致内存泄漏。可以通过pprof的goroutine profile查看goroutine的数量和阻塞情况，访问http://127.0.0.1:6060/debug/pprof/goroutine?debug=1就能看到当前所有goroutine的堆栈信息，找到阻塞的goroutine对应的代码位置。
优化与验证
定位到内存泄漏的原因后，针对性修改代码，比如给全局map增加过期清理逻辑，或者修复goroutine的阻塞问题。修改后重新运行程序，再次通过pprof采集内存数据，观察inuse_space是否保持稳定，不再持续升高，就可以验证问题是否已经解决。
Golangpprof内存泄漏性能分析heap_profile修改时间：2026-06-06 06:15:56