不调用 runtime.setblockprofilerate，/debug/pprof/block 默认为空，因其默认关闭且采样阈值高达1毫秒；设了却抓不到数据主因是调用过晚（须在main开头、任何goroutine启动前）、未导入_ "net/http/pprof"导致404，或误以为?seconds=30能采集历史而实际仅捕获该时段内正在阻塞的goroutine快照。
不调用 runtime.SetBlockProfileRate，/debug/pprof/block 就是空的——它不是“默认采样”，而是默认关闭且采样阈值极高（1 毫秒），绝大多数真实阻塞根本不会被记录。
为什么设了 runtime.SetBlockProfileRate 还抓不到阻塞数据
常见错误不是参数写错，而是时机和配套缺失：
- 调用太晚：必须在
main()开头、任何 goroutine 启动前执行；若在 HTTP server 启动后才设，早期阻塞全漏掉 - 没注册 pprof handler：没导入
_ "net/http/pprof"或没挂到http.ServeMux，访问/debug/pprof/block直接 404 或返回空 profile - 采样窗口误判：
?seconds=30是 HTTP handler 的响应超时，不是“采集 30 秒历史”，而是“等待 30 秒内发生的当前阻塞快照”；若这期间没 goroutine 正卡着，profile 就为空 - 默认阈值太高：Go 默认
SetBlockProfileRate值为1e6（即 1 毫秒），意味着阻塞时间
runtime.SetBlockProfileRate 参数怎么选才合理
rate 不是“每秒采样次数”，而是「阻塞持续时间的纳秒级下限」：只有阻塞时长 ≥ rate 的事件才会被记录。单位是纳秒，但语义更接近“最小可观测阻塞粒度”：
-
runtime.SetBlockProfileRate(0)：彻底关闭，/debug/pprof/block永远无数据 -
runtime.SetBlockProfileRate(1)：记录所有阻塞事件（无论多短），调试可用，线上高并发服务会明显拖慢 -
runtime.SetBlockProfileRate(10000)（10 微秒）：平衡点，能捕获大部分 channel 和锁等待，性能开销可控 -
runtime.SetBlockProfileRate(100000)（100 微秒）：适合压测或线上轻量观测，过滤掉大量瞬时抖动
别信“设成 1 就最准”——真实服务里，设成 1 可能让 P99 延迟翻倍；也别沿用默认的 1e6，那基本等于没开。
怎么确认 block profile 真正在工作
光看 wget 是否成功没用，得验证 profile 里有有效堆栈：
- 先 curl
http://localhost:6060/debug/pprof/block?seconds=10抓一次，保存为block.prof - 运行
go tool pprof block.prof，进入交互模式后输入top—— 如果 top 几行全是runtime.gopark、runtime.semasleep，且没有业务函数名，说明没采到有效调用栈（大概率是没触发真实阻塞，或 rate 设太高） - 真正有效的 profile，
top输出里应出现你的 handler、DB 调用、channel 操作等函数名，且flat时间不为 0 - 用
web命令生成火焰图，重点看调用链顶部（不是底部 runtime 层）是否指向你自己的代码路径
block profile 和 mutex profile 完全不是一回事
两者数据源、触发条件、分析目标都不同，混用会导致误判：
-
blockprofile 记录的是 goroutine 进入休眠的瞬间：比如chan send卡住、sync.Cond.Wait没被 signal、net.Conn.Read等待网络数据 -
mutexprofile 只统计sync.Mutex.Lock和sync.RWMutex的争用，靠runtime.SetMutexProfileFraction控制，和SetBlockProfileRate无关 - 看到大量
semacquire不代表一定是锁问题——它可能是 channel、WaitGroup、甚至 timer.Sleep 的底层实现；要往上翻栈，找到第一个非 runtime 的调用者 - 如果怀疑是锁瓶颈，优先抓
/debug/pprof/mutex；如果 goroutine 数暴涨但 CPU 很低，才该盯block
真正难的从来不是设对那个数字，而是从 runtime 底层的几十层栈里，准确识别出哪一行业务代码让 goroutine 停了下来——profile 给的是线索，不是答案。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
