Go pprof阻塞 profile 没有数据怎么办

访问 /debug/pprof/block 却看不到有效调用栈，通常不是 pprof “坏了”，而是阻塞采样根本没有开启，或者采集窗口内没有发生可记录的阻塞。Go 的阻塞 profile 由运行时采集，net/http/pprof 只负责把它以 HTTP 入口提供出来；两层少一层，页面都可能是空的。

先判断是入口空，还是采样空

排查时不要只反复刷新 pprof 页面。先把现象拆成四层：程序是否导入了 net/http/pprof，运行时是否调用了 SetBlockProfileRate，采集期间是否真的产生 goroutine blocking event，以及命令是否读取了正确的 profile 名称。

把阻塞采样配置放在进程启动阶段

最小配置是导入 pprof 并在服务启动前设置采样率。rate=1 代表尽量记录每个阻塞事件，适合短时间定位；长期运行可以使用更大的纳秒间隔，降低采样成本。不要把它误写成 CPU profile 的 Hz 参数，它表示阻塞时长采样间隔。

package main

import (
    "log"
    "net/http"
    _ "net/http/pprof" // 注册 /debug/pprof/ 下的标准处理器
    "runtime"
)

func main() {
    runtime.SetBlockProfileRate(1) // 短窗口排障：记录每个阻塞事件

    go func() {
        // 独立监听调试端口，避免把 profile 路由混入业务 mux。
        log.Println(http.ListenAndServe("127.0.0.1:6060", nil))
    }()

    select {} // 示例保持进程存活；生产代码应使用真实服务生命周期
}

如果这里传入了小于等于零的值，阻塞 profile 会被关闭；如果调用发生在业务压力已经结束之后，后面的采集也不会补回过去的事件。因而配置位置和采集窗口都很重要。

用正确入口制造可解释的采集窗口

标准入口是 /debug/pprof/block，读取工具可以直接拉取它。对 block profile 使用 seconds=N 时，得到的是这个时间窗口的增量视图；窗口太短而服务又很空闲，空结果是合理的。排查锁竞争或通道等待时，应让压测或真实请求覆盖到可疑路径，再开始采集。

# 读取 20 秒窗口内的阻塞采样；不要把 block 写成 profile
go tool pprof "http://127.0.0.1:6060/debug/pprof/block?seconds=20"

# 也可以先保存文件，再在本地查看调用栈
curl -o block.pb.gz "http://127.0.0.1:6060/debug/pprof/block?seconds=20" # 保存增量 profile
go tool pprof block.pb.gz # 进入 pprof 交互界面查看 top 和调用图

若程序使用的不是 http.DefaultServeMux，仅仅导入 pprof 不会自动把处理器挂到自定义 mux 上，需要显式注册对应 handler。此时先用一个已知可用的调试路由确认 mux，再检查 block 路由，能避免把路由问题误判成 profile 空。

空结果时的复查顺序和边界

1. 检查进程启动路径是否必然执行 SetBlockProfileRate，避免只在某个测试分支设置。
2. 确认采集期间确实有锁等待、通道收发等待、select 等阻塞，而不是只有 CPU 忙循环。
3. 把窗口从很短时间延长到能覆盖一轮请求，再观察 profile 是否出现；不要用一次空结果证明系统没有阻塞。
4. 把 block profile 与 goroutine、mutex profile 对照。block 关注 goroutine 阻塞时长，mutex 更适合看互斥锁竞争的持有者。

实际排障中，先用 rate=1 做短窗口定位，再根据开销改成更稀疏的采样率。profile 的数据是采样结果，调用栈排名只能说明“记录到的阻塞集中在哪里”，还需要结合请求量和代码路径判断根因。

常见问题

只导入 net/http/pprof，为什么 block 还是没有数据？

导入包主要负责注册 HTTP 处理器，不会替你开启阻塞事件采样。还需要在进程中调用 runtime.SetBlockProfileRate，并在采集窗口内产生阻塞。

rate 应该一直设置为 1 吗？

不一定。短时间定位问题可以用 1，长期在线采样应结合开销和目标精度选择更大的间隔；关键是不要把它当成 CPU 采样频率。

block profile 和 mutex profile 能互相替代吗？

不能。前者描述 goroutine 的阻塞事件，后者聚焦互斥锁竞争。两者可以对照使用，但空的 block profile 不能直接推出没有锁竞争。