pprof 生成的 profile 文件需先用 go tool pprof -raw -lines 导出为折叠栈文本,再经 flamegraph.pl 转为 SVG 火焰图;Web 界面无火焰图按钮,需手动访问 /ui/flamegraph;线上启用 CPU profiling 要限制 seconds 参数并管控访问权限;符号显示为 ? 或 [unknown] 是因编译时 strip 了符号表,应去掉 -ldflags="-s"。

pprof 生成的 profile 文件怎么转成火焰图
Go 自带的 pprof 默认输出的是文本或交互式 Web 视图,不直接生成火焰图。火焰图需要把采样数据转换成 flamegraph.pl 能读的折叠栈格式(folded stack format),再用 Perl 脚本绘图。
实操分三步:
- 用
go tool pprof导出原始采样数据为文本栈(不是 SVG!):go tool pprof -raw -lines your_binary cpu.pprof > stacks.txt - 用官方
flamegraph.pl脚本处理:./flamegraph.pl stacks.txt > flame.svg(脚本需从 Brendan Gregg 仓库 下载) - 注意:Go 1.21+ 默认开启
runtime/trace的 goroutine 抢占采样,但pprofCPU profile 仍基于信号中断,两者数据源不同,别混用trace和pprof的输入
web 模式下为什么看不到火焰图按钮
pprof 的 Web 界面(go tool pprof -http :8080 cpu.pprof)里没有“火焰图”按钮,这是设计如此——它只提供调用图(callgraph)、火焰图(flame graph)是独立渲染逻辑,不在默认 UI 中。
常见误解是点开 Web 页面后找图标或菜单,其实它压根不提供这个入口。要真想在浏览器里看,得手动构造 URL:
立即学习“go语言免费学习笔记(深入)”;
- 启动时加
-http后访问http://localhost:8080/ui/flamegraph(Go 1.20+ 支持,但仅限 CPU profile) - 该页面本质仍是调用
flamegraph.pl的封装,底层依赖本地 Perl 环境;若报错exec: "perl": executable file not found,说明没装 Perl 或路径不对 - Web 版火焰图不支持 zoom-in/out 的交互缩放,不如本地生成的 SVG 灵活
net/http/pprof 服务中如何安全开启 CPU profiling
线上服务用 net/http/pprof 暴露 /debug/pprof/profile 接口时,CPU profiling 是阻塞式采集,默认持续 30 秒,会卡住一个 goroutine,且期间无法响应其他 pprof 请求。
必须控制参数,避免误操作拖垮服务:
- 用
?seconds=5显式缩短时间,例如:curl "http://localhost:6060/debug/pprof/profile?seconds=5" -o cpu.pprof - 别在高 QPS 服务上用默认 30 秒;5 秒通常够定位热点,10 秒以上需谨慎评估影响
- HTTP 接口不校验权限,生产环境务必限制访问来源(如 Nginx 白名单)或移除
net/http/pprof,改用本地go tool pprof直连 profile 文件
火焰图里 Go runtime 符号显示为 ? 或 [unknown]
火焰图顶部大量 [unknown] 或 ?,不是数据丢了,而是符号表缺失——Go 编译时默认 strip 掉调试信息,或者二进制被 strip 过。
关键修复点就一个:
- 编译时加
-ldflags="-s -w"会同时去掉符号和 DWARF,导致 pprof 完全无法解析函数名;去掉-s(只留-w去掉 DWARF)即可保留符号表 - 如果已部署的二进制是 stripped 的,
pprof无法恢复;只能重新编译并保留符号,或用go build -gcflags="all=-l" -ldflags="-w"禁用内联来增强栈可读性 - 交叉编译(如 macOS 编译 Linux 二进制)时,确保目标平台的
addr2line或objdump可用,否则本地 pprof 解析符号会失败
火焰图真正有用的地方,是你能一眼看出哪一行代码在 CPU 上烧得最旺;但如果符号都对不上,再漂亮的图也只是彩色噪音。











