go tool pprof 导出火焰图需用 -raw -lines 参数生成折叠栈格式:go tool pprof -raw -lines ./myapp cpu.pprof > stacks.txt;必须禁用 strip,确保符号完整;再用 flamegraph.pl 渲染为 svg。

怎么用 go tool pprof 导出火焰图需要的折叠栈
Go 自带的 pprof 默认不生成火焰图,它输出的是交互式 Web 或文本调用树。火焰图依赖的是「折叠栈格式」(folded stack),一种每行代表一个调用路径、用分号拼接的纯文本,比如:main.main;http.Serve;net/http.(*conn).serve;runtime.goexit。
关键命令是加 -raw -lines 参数导出原始采样数据:
-
go tool pprof -raw -lines ./myapp cpu.pprof > stacks.txt—— 必须用-raw,否则会做符号解析/聚合,丢失原始栈帧;-lines能保留行号,定位更准 - 别用
-text或-top,那只是摘要,不能喂给flamegraph.pl - 如果二进制被 strip 过(比如用了
-ldflags="-s"),栈里会大量出现[unknown]或?,得重新编译去掉-s
为什么 /ui/flamegraph 按钮不显示或点不动
Go 1.21+ 的 pprof Web 界面默认不展示「Flame Graph」按钮,不是你配置错了,是它压根没放出来 —— 只有手动访问 /ui/flamegraph 路径才生效。
- 启动 Web 查看器:
go tool pprof -http=:8080 cpu.pprof - 然后直接浏览器打开
http://localhost:8080/ui/flamegraph,别点左上角菜单 - 这个页面是纯前端渲染,不走后端计算,所以加载快;但前提是你的
cpu.pprof文件里真有足够采样(至少 5 秒以上) - 如果页面空白或报
no profile data,大概率是采集时长太短,或程序根本没跑起来(比如 HTTP 服务没监听、profile 接口被防火墙拦了)
线上服务跑 profile?seconds=30 有多危险
CPU profiling 是基于信号中断的,每秒默认 100 次,对高 QPS 服务就是实打实的性能损耗。30 秒不是“保险时长”,而是“风险阈值”。
- 生产环境建议上限 5 秒:
profile?seconds=5,通常够暴露 top3 热点 - 别在流量高峰期间采,尤其别在凌晨自动触发 —— 曾有团队因定时 job 触发 30 秒 CPU profile,导致订单接口 P99 延迟从 80ms 拉到 2.3s
- HTTP 接口无鉴权,
/debug/pprof必须用 Nginx 白名单限制 IP,或干脆关掉,改用本地go tool pprof直连文件(如从容器docker cp拷出 profile 再分析) - Go 1.21+ 默认开启
runtime/trace的 goroutine 抢占采样,但它和pprof/profile数据源不同,混着看会误导 —— 别拿trace的火焰图当pprof用
用 flamegraph.pl 生成 SVG 的实际卡点
官方不打包 flamegraph.pl,得自己下,而且 Perl 脚本对输入格式极其敏感 —— 少个换行、多空格、乱码都会让输出 SVG 完全不可读。
- 脚本必须从 Brendan Gregg 官仓拿:
wget https://raw.githubusercontent.com/brendangregg/FlameGraph/master/flamegraph.pl - 确保
stacks.txt是 UTF-8 且无 BOM,Windows 下用记事本保存容易带 BOM,推荐用 VS Code 或iconv -f utf-8 -t utf-8//IGNORE stacks.txt清理 - 生成命令要加
--title和--countname提升可读性:./flamegraph.pl --title "CPU usage (5s)" --countname "samples" stacks.txt > flame.svg - 生成的
flame.svg用 Chrome 打开即可缩放/搜索函数名;别用 Safari —— 它对大 SVG 渲染慢且偶尔错位
最常被忽略的一点:火焰图只告诉你「哪段代码耗时多」,不告诉你「为什么多」。比如看到 json.Marshal 占比高,得接着查是不是结构体字段太多、有没有循环引用、是否重复 Marshal 同一对象 —— 图只是起点,不是结论。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











