Go pprof 为什么 CPU 图里没有业务函数

Go pprof CPU 图里没有业务函数，通常不代表 pprof 失效。先看两个边界：采样窗口是否真的覆盖了业务 CPU，以及查看 profile 时是否使用了生成它的匹配二进制。前者会让图里只剩等待、调度或系统调用，后者会让地址无法还原成可读的函数名。

官方入口：https://pkg.go.dev/runtime/pprof/

先用原始文本视图确认 profile 是否有业务样本，再检查匹配二进制和过滤参数；不要一开始就根据一张空图判断程序没有热点。

一、先界定 CPU profile 里应该有什么

CPU profile 记录的是程序主动消耗 CPU 的采样，不是“这段时间所有 goroutine 的状态快照”。如果采样的 30 秒里服务大多在等网络、等锁、等定时器，业务函数本来就可能很少，图中出现 runtime.gopark、调度器或系统调用并不等于符号丢失。

把 profile 当成需要保护的诊断资产，至少要保留三项关系：采样文件、采样期间的负载，以及生成该文件的构建二进制。少了其中一项，后面的热点结论就不稳。

二、攻击路径一：采样时段没有覆盖业务 CPU

最常见的误判是服务刚启动就抓 profile，或者先请求 profile，再过很久才开始压测。HTTP pprof 的采样接口应与实际请求或压测重叠：

# 采样期间同时发送业务请求，避免只捕获空闲等待
curl -o cpu.pprof "http://127.0.0.1:6060/debug/pprof/profile?seconds=30"

# 用文本视图先确认热点是否出现，避免被图形界面的过滤状态误导
go tool pprof -text ./service cpu.pprof

如果文本结果里主要是等待函数，先增加真实业务负载或延长采样，而不是立刻重编译。CPU profile 的结论只适用于它覆盖的那段工作负载；网络等待多的接口也可能天然没有明显的业务 CPU 热点。

三、攻击路径二：profile 与二进制没有匹配

go tool pprof 可以读取 profile，并在需要时借助本地二进制补齐函数和源码位置。排查时不要随手拿“当前最新构建”替代采样时运行的产物：函数移动、重命名、构建模式不同，都会让地址与符号关系变得不可靠。

# 第一个参数应是采样时运行的同一构建产物
# -symbolize=local 只从本地二进制寻找符号，便于复查符号来源
go tool pprof -symbolize=local -text ./service cpu.pprof

# 需要图形视图时仍沿用同一个二进制和 profile
go tool pprof -http=:0 ./service cpu.pprof

如果发布产物经过裁剪，或容器只保留了无法用于本地符号化的文件，保留一份与线上构建身份对应的未裁剪二进制用于分析。不要把“能启动的二进制”误认为“能还原 profile 符号的二进制”。在 cgo 参与的场景，还要把 Go 栈和本地代码符号化分开看，不能只凭 Go 函数列表判断全部调用链。

四、攻击路径三：过滤参数把业务节点隐藏了

如果原始 -text 输出能看到业务函数，而网页图没有，优先检查查看参数。focus、ignore、节点比例阈值和调用图层级都会改变可见范围。先清掉筛选，再逐项加回；这样能区分“profile 没有样本”和“视图主动隐藏”。

# 先查看未加 focus/ignore 的原始热点
go tool pprof -text ./service cpu.pprof

# 确认业务包出现后，再按包名缩小范围
# 正则中的点号要转义，避免把无关函数一起匹配
go tool pprof -focus='example\\.com/project/handler' -text ./service cpu.pprof

建议把每次分析的采样时段、服务构建标识、二进制路径和过滤参数写进记录。它们分别回答“样本从哪里来”“符号对应谁”“工具拿什么解析”和“图为什么这样显示”。

五、复查清单与相关问题

可以按下面顺序收口：第一，确认文件是 CPU profile；第二，确认采样时有真实业务负载；第三，使用采样时的匹配二进制；第四，清除过滤参数查看原始文本；第五，再根据函数名、源码位置和调用关系做结论。若始终没有业务函数，才继续检查构建产物是否被裁剪、是否混入 cgo，以及 profile 是否来自另一版本。

为什么 CPU 图里只有 runtime.gopark？通常说明采样窗口内 goroutine 多在等待，并不自动说明业务符号缺失。

为什么换成当前二进制后函数名仍不对？profile 与二进制不是同一次构建时，地址、内联信息或函数名称可能无法可靠对应，应找回采样时的构建产物。

为什么文本视图有函数，网页图却没有？优先检查 focus、ignore、节点阈值和当前视图层级，图形界面可能沿用了旧筛选。