pprof 默认不生成火焰图，因其仅输出采样数据，火焰图需第三方工具（如flamegraph.pl）或go tool pprof -http渲染；gin需显式导入net/http/pprof并安全挂载/debug/pprof路由。
为什么 pprof 默认不生成火焰图？
因为 pprof 本身只是分析工具，它输出的是采样数据（如 profile 文件），火焰图是第三方可视化产物。Gin 默认不集成火焰图生成链路——它只负责把 /debug/pprof/ 路由挂载好，剩下的要你自己导出数据、用 go tool pprof 处理、再用 flamegraph.pl 渲染。
常见错误现象：curl http://localhost:8080/debug/pprof/profile 返回二进制内容直接保存为 profile，但双击打不开、或用 pprof 打开后只能看文本调用树，没火焰图。
- 必须用
go tool pprof -http=":8081" profile启动 Web 界面，再点「Flame Graph」标签页才能看到（这是内置渲染，非 SVG 火焰图） - 若要生成可分享的 SVG 火焰图，得额外安装
flamegraph.pl（来自 Brendan Gregg 的FlameGraph仓库） - Gin 没有自动启用
net/http/pprof，必须显式导入并注册：需import _ "net/http/pprof"，否则/debug/pprof/根本不存在
如何在 Gin 中安全启用 pprof 路由？
别直接 r.GET("/debug/pprof/*pprof", gin.WrapH(pprof.Handler()))——这会暴露全部 pprof 接口到公网，且绕过 Gin 中间件（比如鉴权）。正确做法是复用标准库的 http.ServeMux，仅在开发环境挂载，并加路由前缀隔离。
- 开发时用
if gin.Mode() == gin.DebugMode控制是否注册，生产环境彻底剔除 - 推荐挂载到独立端口（如
:6060），避免和主服务混用：go http.ListenAndServe(":6060", http.DefaultServeMux) - 如果必须走 Gin 路由，用
gin.WrapH(http.DefaultServeMux)包一层，但前提是已调用import _ "net/http/pprof"初始化 - 不要手动实现
pprofhandler——标准库的逻辑含采样锁、goroutine 安全检查，自己抄容易出竞态
go tool pprof 生成 SVG 火焰图的关键参数
命令行默认行为不是生成 SVG，必须指定输出格式和输入源。最易踩的坑是路径写错、采样时间太短、或用了 cpu profile 却没持续压测。
- 采集 CPU 数据：
curl -s "http://localhost:6060/debug/pprof/profile?seconds=30" > cpu.pprof（注意：必须持续请求 30 秒，期间要有真实流量） - 生成 SVG：
go tool pprof -svg -output flame.svg cpu.pprof（-svg必须在-output前） - 若提示
failed to fetch any profiles，检查是否启用了runtime.SetMutexProfileFraction(1)或runtime.SetBlockProfileRate(1)——这些需代码中主动开启，不能靠 URL 参数 - 内存 profile 不支持
-svg直出，得先go tool pprof mem.pprof进交互模式，再用web或peek查看，SVG 需配合flamegraph.pl
用 flamegraph.pl 补全缺失的火焰图能力
Go 自带 pprof 的 SVG 输出较简陋（无折叠/搜索/着色分级），而 flamegraph.pl 是业界通用方案，尤其适合对比多个 profile。
- 下载：
wget https://raw.githubusercontent.com/brendangregg/FlameGraph/master/flamegraph.pl，加执行权限 - 配合
go tool pprof导出折叠栈：go tool pprof -traces cpu.pprof | ./flamegraph.pl > flame.svg - 注意：
-traces输出的是原始调用栈文本，flamegraph.pl依赖该格式；若用-text或-top就失效 - Gin 路由名不会出现在栈中——
pprof记录的是 Go 函数调用，不是 HTTP 路径。想定位慢接口，得结合pprof.Lookup("goroutine").WriteTo看阻塞点，或用中间件打日志+采样标记
火焰图真正难的不是生成，而是读懂：扁平宽的函数块未必是瓶颈，要看它上面有没有长条「压顶」；Gin 的 c.Next() 在火焰图里几乎不可见，实际耗时都沉在你写的 handler 里——这点很容易误判。
