Go pprof 采样为什么看不到短生命周期函数

Go pprof 采样看不到短生命周期函数，通常不是 pprof 把这个函数过滤掉了，而是 CPU profile 只在采样点记录当时的调用栈。一次调用很短、调用次数又少时，执行区间可能没有撞上采样点；即使每次都很短，只要它被高频反复调用并占用了足够 CPU 时间，也可能在聚合结果中出现。

CPU profile 为什么会漏掉短函数

Go 的 CPU profiler 按固定频率采样。当前运行时实现把 CPU profile 的采样频率设为 100 Hz，可以把它理解成平均每 10 毫秒观察一次正在消耗 CPU 的调用栈。采样点到来时，函数正好在栈上，才有机会为它贡献一个样本。

因此，短函数的两个条件要分开看：

这也解释了一个常见误判：函数在业务日志里出现过，只能证明它执行过，不能证明 CPU 采样点曾经落在它的执行区间内。CPU profile 是统计工具，不是完整调用轨迹。

采样次数少不等于函数没有执行

可以把函数是否出现拆成两个问题。第一个问题是有没有命中采样点，第二个问题是命中后样本数量是否足以在输出中显眼。低频短调用可能既没有命中，也可能只命中一两次；高频短调用虽然单次很短，但累计 CPU 时间高，最终仍可能排在 top 前列。

如果函数只负责很轻的字段转换、一次缓存读取或一次短暂的调度，它可能会被调用栈中的上层函数吸收，或者在展示时因为样本太少而不明显。这不是“短函数永远不会出现”，而是样本数量与统计噪声共同决定了可见度。

怎样重新采集，避免把采样窗口当成结论

先保证采样覆盖了目标工作负载。对基准测试，可以用 go test 生成 CPU profile；对常驻服务，则让 profile 覆盖足够多的同类请求。下面是一个最小的基准采集命令：

# 只运行目标基准，并把 CPU profile 写入文件
go test -run '^$' -bench BenchmarkDecode -benchtime=30s -cpuprofile cpu.prof ./...

# 先看聚合后的热点，再定位某个函数所在的调用路径
go tool pprof -top cpu.prof
go tool pprof -list=decodeRecord cpu.prof

命令里的 30s 不是“短函数必须执行 30 秒”，而是给统计更多采样机会。-list 用来查看指定函数的源码位置和样本分布；如果函数仍然没有出现，再检查基准是否真的走到了这条路径，以及它是不是主要在等待而不是消耗 CPU。

手动采集时，要把停止动作放在采样范围的末尾，并正确关闭输出文件：

package main

import (
    "log"
    "os"
    "runtime/pprof"
)

func collectCPUProfile() {
    // 创建 profile 文件；真实项目应把路径改成可配置项。
    f, err := os.Create("cpu.prof")
    if err != nil {
        log.Fatal("创建 CPU profile 失败：", err)
    }
    defer f.Close() // 确保采集结束后释放文件描述符。

    if err := pprof.StartCPUProfile(f); err != nil {
        log.Fatal("启动 CPU profile 失败：", err)
    }
    defer pprof.StopCPUProfile() // 等待 profile 写完后再离开采样范围。

    runWorkload() // 这里必须真正覆盖要分析的短函数调用路径。
}

func runWorkload() {
    // 这里只表示业务负载入口，不把示例输出当作运行证据。
}

看到空结果时按这张清单排查

1. 采样范围是否覆盖目标调用。服务 profile 采集开始得太晚，或基准没有执行目标分支，都会得到“看不到”的结果。
2. 采样时长是否足够。偶发短调用需要更长窗口或更多同类请求，不能用一次请求下结论。
3. 看的是否是 CPU profile。如果问题是等待、锁竞争或 goroutine 数量，应该换对应的 block、mutex 或 goroutine profile；CPU profile 不会完整记录这些事件。
4. 是否只看了 top。聚合排名靠后的函数可以用 list 或调用图继续定位，但不要把没有出现在 top 当成“没有执行”。
5. 是否混用了不同负载。采集期间负载变化会稀释目标函数的样本，最好让 profile 窗口对应一个稳定、可重复的场景。

相关问题

短函数执行不到 10 毫秒就一定采不到吗？

不一定。采样是概率事件，不是按 10 毫秒给函数设置硬门槛。短函数被高频调用时，累计执行时间足够大，仍可能被多次采到；低频调用则更容易漏掉。

为什么函数执行过，但 pprof top 中没有它？

日志记录的是调用事件，CPU profile 记录的是采样命中的调用栈。先延长窗口并稳定负载，再用 list 检查函数是否只占很少样本。

pprof 能不能用来证明每次调用都发生了？

不能。CPU profile 适合找 CPU 时间热点，不是调用计数器或完整追踪。如果需要每次调用都可见，应在业务层使用计数、trace 或有边界的日志来记录事件。

最后可以记住：pprof 看不到短生命周期函数，优先怀疑“采样点没有命中”或“累计 CPU 占比太低”，而不是先认定函数没有执行。延长采样窗口、稳定工作负载，再结合 top 和 list，才能把统计结果读对。