使用 go tool trace 分析 channel 阻塞，需先生成包含运行时调度事件的 trace.out 文件，重点查看 Goroutine analysis 和 Synchronization blocking profile 视图定位阻塞点。适用场景为复现本地问题或测试环境抓包，生产环境需谨慎开启避免性能开销。
先说结论：trace 工具记录 goroutine 调度、GC 和系统调用等时间线事件，能直观展示 channel 收发阻塞状态，区别于 pprof 的统计快照。
- 先确认：trace 文件有效（类型正确且非空，大小应大于 1KB）
- 先处理：视图筛选聚焦 Blocked 状态协程，排查 chan send/recv 操作
- 再验证：结合代码栈定位阻塞根因，确认是否为锁争用或下游依赖慢
命令速用版
本地生成并查看 trace 文件：
go tool trace trace.out生产环境或运行中服务动态采集（需启用 net/http/pprof）：
curl http://localhost:6060/debug/pprof/trace?seconds=30 > trace.out启动可视化服务后，浏览器访问终端输出的 http://127.0.0.1:随机端口 地址。
为什么会这样
trace 工具记录的是运行时事件时间线，而非单纯的函数耗时统计。channel 阻塞在 trace 中表现为 goroutine 长时间处于 Blocked 或 GCWaiting 状态，而非 CPU 占用高。当 channel 读写双方都阻塞且无其他 runnable 协程时，runtime 才会报 deadlock panic，而 trace 能在 panic 前捕捉到阻塞等待过程，帮助定位“看似没死锁但程序不推进”的情况。
分步处理
1. 代码插桩：在 main 函数开头调用 trace.Start 创建文件，defer trace.Stop 确保退出前 flush 数据，避免放在 http.ListenAndServe 之后导致请求事件不可见。
2. 生成文件：运行程序确保实际业务逻辑被执行，若程序退出过快需加 time.Sleep 留出采集窗口，避免文件只有启动/停止两个事件。
3. 打开界面：执行 go tool trace trace.out 启动本地 Web 服务，端口随机且仅限 127.0.0.1，不支持远程访问。
4. 分析视图：进入界面后先查看 Goroutine analysis 筛选 Blocked 状态，再查 Synchronization blocking profile 确认互斥锁或 channel 阻塞总时长，最后看 Syscall blocking profile 识别系统调用卡住位置。
怎么验证是否生效
使用 file trace.out 命令确认文件类型为“Go execution trace”，检查文件大小应大于 1KB，若只有几百字节说明 trace.Stop 未执行或采集时间太短。在可视化界面中若显示“no trace events”，通常是 trace.Start 调用太晚或程序未真正运行协程。浏览器无法加载时尝试更换 Chrome 或 Firefox，Mac 上 Safari 可能因安全策略拒绝加载本地 trace 数据。
常见坑
1. 启动时机错误：把 trace.Start 放在 http.ListenAndServe 之后，导致所有请求处理事件不可见。
2. 文件损坏：使用 log.Fatal 或 os.Exit(1) 提前终止会绕过 defer，导致 trace.Stop 不执行，文件末尾损坏报错 EOF。
3. 性能开销：trace 记录有明显性能开销，别在生产环境长期开着，建议配合 pprof 接口按需采样。
4. 视图误解：time.Sleep 不会出现在阻塞视图里（属于主动让出 CPU），阻塞是指等资源，如 http.Get 中的 DNS 解析或 TCP 握手。
常见问题
trace 和 pprof 有什么区别？
pprof 是统计快照，适合查热点函数和内存分配；trace 是时间线录像，适合分析单次请求生命周期、GC 影响和协程调度阻塞。
为什么提示“no trace events”？
大概率是 trace 文件内容为空或格式损坏，或者 trace.Start 调用太晚没覆盖实际业务逻辑，与浏览器无关。
所有 goroutine 阻塞一定会报 deadlock 吗？
仅当程序中没有一个 goroutine 处于 runnable 状态才会 panic，若只剩一个 goroutine 卡在 select{} 或未关闭的 chan 上也会触发，但逻辑错误导致的阻塞不一定触发 panic。
参考来源
- trace 工具怎么看？goroutine 阻塞分析实战
- Golang 怎么用 go tool trace 分析调度_Golang 如何用 trace 工具可视化协程调度情况【进阶】
- 如何在 Golang 中检测死锁 Deadlock 常见场景 Go 语言并发故障排查
- Go 语言 trace 工具使用教程_Golang 运行时事件追踪分析