goland 无法直接查看 block profile，必须通过 go tool pprof 分析：先确保 runtime.setblockprofilerate(1) 在 main() 开头调用、_ "net/http/pprof" 正确导入、http server 监听并暴露 /debug/pprof/block 接口，再用 wget 抓取数据后执行 go tool pprof -http=:8081 block.prof 进行可视化分析。

GoLand 里直接看不了 block profile，得靠外部 pprof 工具

GoLand 本身不解析或渲染 block profile 数据——它没有集成 go tool pprof 的可视化逻辑，也不支持加载 /debug/pprof/block 原始响应。你看到的「Profile」菜单里的选项（如 CPU、Memory）只对接 GoLand 自带的采样器，对 block profile 完全无效。

真正能定位协程阻塞点的，只有两件事：拿到 block.prof 文件 + 用命令行 go tool pprof 分析。GoLand 只能帮你启动服务、加断点、查日志，不能替代这一步。

必须先让程序暴露 /debug/pprof/block 接口

常见错误是只写了 import _ "net/http/pprof"，但没做三件事中的任意一个：

• runtime.SetBlockProfileRate(1) 没在 main() 最开头调用（生产环境建议设为 100 或 1000，不是 1）
• HTTP server 没监听（比如只起了业务端口 :8080，但没额外开 127.0.0.1:6060）
• 用了 Gin/Echo 等框架，却没手动挂载 pprof handler（router.Any("/debug/pprof/*pprof", gin.WrapH(http.DefaultServeMux))）

验证是否生效：访问 http://localhost:6060/debug/pprof/ 能看到列表，再点 block 链接，返回内容非空且含 goroutine 字样才算成功。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

抓取 block.prof 后，用 go tool pprof 分析关键路径

别在 GoLand 终端里直接跑 go tool pprof 然后卡在交互模式——容易漏掉重点。推荐流程：

• 用 wget -O block.prof 'http://localhost:6060/debug/pprof/block?seconds=30' 抓 30 秒数据（确保期间有真实阻塞压力，否则文件为空）
• 运行 go tool pprof -http=:8081 block.prof，打开 http://localhost:8081
• 进界面后，点右上角 View → Top，把排序方式切到 Cum（不是 Flat），重点关注调用栈顶部的业务函数名，比如 UpdateUserCache、handleOrder
• 看到 sync.(*Mutex).Lock 下面紧跟着你的函数？说明锁没释放；看到 chan receive 上面是 processEvent？说明 channel 没人收或缓冲区满

容易被忽略的两个硬性条件

就算代码全对、GoLand 跑着、pprof 页面能打开，/debug/pprof/block 依然可能返回空：

• 程序当前没发生真实阻塞：QPS 太低、压测没打满、请求根本没走到锁/channel/I/O 路径
• runtime.SetBlockProfileRate 调用太晚：比如放在 HTTP server ListenAndServe 之后，那启动阶段的阻塞事件就永远丢失了

block profile 统计的是「总等待时间」，不是「当前卡住几个 goroutine」。一个函数在 top 里占比高，未必是它写得差，可能是被高频调用+每次等几毫秒——得结合调用频次和业务语义一起判断。