Go pprof profile 为空时先确认什么

Go 的 pprof profile 为空，第一反应不要先改 go tool pprof 参数。先看三件事：采集的 profile 类型是否正确，采样窗口内有没有目标工作，以及 profile 是否已经完成写入。CPU profile 需要一段持续采样时间；block 和 mutex profile 依赖运行时采样开关；手动写文件时还必须等 StopCPUProfile 完成。

先分清是哪一种 profile 为空

pprof 不是一个单一快照。CPU profile 记录采样窗口里的执行栈，heap 更接近某个时点的内存快照，goroutine 通常直接反映当前协程栈，而 block、mutex 记录的是特定同步事件。把 /debug/pprof/heap 当成 CPU 文件，或把没有启用采样的 block profile 当成“没有阻塞”，都会得到错误结论。

CPU profile 先看采样窗口和工作负载

net/http/pprof 的 /debug/pprof/profile 默认采样 30 秒，也可以用 seconds=N 指定正整数时长。请求刚发出就取消、程序很快退出，或者采样窗口内服务没有执行目标函数，文件可能存在但样本非常少，甚至看起来为空。排查时让压测、批处理或真实请求与采样窗口重叠，不要只访问一次空闲服务。

独立程序用 runtime/pprof 时，CPU 数据会先缓冲，StopCPUProfile 返回后才算完成写出。推荐把停止动作和文件关闭都放进 defer，并注意后注册的 defer 先执行：

func writeCPUProfile(path string) error {
    f, err := os.Create(path)
    if err != nil {
        return err // 文件创建失败时不要继续启动采样
    }
    defer f.Close() // StopCPUProfile 会先执行，最后再关闭文件

    if err := pprof.StartCPUProfile(f); err != nil {
        return err // 已有 CPU profile 时会在这里返回错误
    }
    defer pprof.StopCPUProfile() // 等待缓冲数据写完再让函数返回

    runWorkload() // 这里应放真实的计算或请求负载
    return nil
}

HTTP 方式可用下面的命令明确采样时长。命令输出中的 Total samples 仍然很小，就回到“窗口内有没有负载”检查；不要把样本少误判成 pprof 解析失败。

# 让采样窗口覆盖一段真实请求，再查看 CPU 热点
go tool pprof -top -seconds=10 \
  http://127.0.0.1:6060/debug/pprof/profile

阻塞与互斥 profile 要先打开采样

block profile 需要 runtime.SetBlockProfileRate，mutex profile 需要 runtime.SetMutexProfileFraction。它们的默认配置不等于“持续记录所有事件”，所以读取到空或没有有用样本时，先确认初始化代码确实执行，并且采样期间真的发生了 channel、锁或其他同步等待。

另外，heap 和 allocs 的含义不同：heap 更关注当前仍存活的对象，allocs 关注进程生命周期内的分配。需要更新 heap 统计时可以在受控排查中请求 gc=1，但不要因为一次快照没有目标对象就断言“没有分配”。

文件写入与 HTTP 入口的收尾检查

手动文件采集按“创建 Writer → 启动采样 → 执行业务 → 停止采样 → 关闭 Writer → 再读取”的边界处理。HTTP 采集则确认引入了 net/http/pprof，服务实际使用的 mux 注册了对应 handler，并用 GET 请求正确的 /debug/pprof/ 路径。Go 1.22 起这些 pprof 路径要求使用 GET。

最后用这张清单复查：

• 文件大小为零：先查 StopCPUProfile 是否执行、Writer 是否提前关闭。
• 文件非零但没有样本：查 profile 类型、采样窗口和窗口内负载。
• block 或 mutex 没数据：查对应的 runtime 采样开关与实际等待事件。
• HTTP 返回不符合预期：查 handler、GET 方法、路径以及 seconds 是否为正整数。

常见问题

pprof CPU profile 采样 1 秒可以吗？

可以，但短窗口更容易受空闲和瞬时负载影响。排查稳定热点时，应让窗口覆盖足够多的同类请求。

profile 文件非空，为什么 top 仍然没有目标函数？

这通常表示采样期间目标函数没有占据可观察的执行时间，或查看的 profile 类型不是 CPU。先看采样时段和实际流量，再看 profile 名称。

block profile 为空是不是说明没有锁竞争？

不能直接这样判断。先确认已启用 block 采样，并让请求覆盖可能阻塞的代码；否则空结果只说明没有被记录到。