go tool trace可定位goroutine阻塞行号及资源,但需trace.Start()生效、程序真实运行且trace.Stop()执行;优先查看Goroutine analysis、Synchronization blocking profile、Syscall blocking profile三视图。

go tool trace 能直接定位 Goroutine 阻塞在哪一行、等什么资源,但前提是 trace 文件里真有阻塞事件——90% 的“打不开”“no trace events”问题,都卡在 trace.Start() 没生效或程序没真正跑起来。
trace.Start() 必须配对 trace.Stop() 且文件非空
空 trace 文件是所有分析失败的起点。它不是浏览器或命令的问题,而是运行时根本没记下任何调度行为。
-
trace.Start()必须传入一个可写的*os.File,比如os.Create("trace.out");用os.Stdout或漏参数会导致只写内存缓冲区,不落盘 -
trace.Stop()必须执行到,log.Fatal()、os.Exit(1)会跳过defer,结果文件只有头尾两个事件 - 程序若启动后立刻退出(比如只初始化 HTTP server 就停),
trace.out大小可能 time.Sleep(200 * time.Millisecond) 或select{}留出采集窗口 - 验证是否有效:
file trace.out输出应为Go execution trace,且ls -l trace.out显示大小 >1KB
Goroutine 阻塞分析优先看这三个视图
进入 go tool trace trace.out 页面后,别急着点 “View trace”,先按顺序排查:
-
Goroutine analysis:看哪些函数下 Goroutine 长时间处于
Blocked或GCWaiting状态。例如sync.Mutex.Lock、chan send、net/http.read高频出现,基本就是锁争用、channel 缓冲不足或下游响应慢 -
Synchronization blocking profile:专看互斥锁、
RWMutex、WaitGroup、channel 收发的总阻塞时长。若某mutex占比超 30%,大概率是热点锁 -
Syscall blocking profile:识别系统调用卡住的位置,如
read、write、accept——常见于未设timeout的网络请求或文件读写
注意:time.Sleep 不会出现在阻塞视图里(它属于主动让出 CPU),但 http.Get 中的 DNS 解析、TCP 握手、TLS 握手、body 读取都可能触发 syscall 阻塞。
为什么 Scheduler Latency 面板经常不显示
这个面板是查调度延迟的关键,但它默认不激活,必须同时满足三个条件:
- 启动前设置环境变量:
GODEBUG=scheddetail=1,schedtrace=1000 -
trace.Start()前调用runtime.SetBlockProfileRate(1)(值非零即可,这是隐藏触发开关) - 程序中真有阻塞行为(如 channel 等待、锁竞争、syscall),否则 runtime 不会生成 sched 事件
缺任一条件,UI 只显示模糊的 “Proc Status”,不会出现 “Scheduler Latency” 标签页。Go 1.21+ 中 scheddetail 仍有效,但字段含义有调整,别照搬老文档解读。
goroutine 处于 Runnable 却长时间不 Running 怎么查
灰色竖条就是调度延迟本身,重点看 Goroutines 视图里每个 G 的 Runnable 区段长度:
- 如果多个 G 同时卡在
Runnable且持续 >1ms,先看Scheduler latency面板里各 P 的延迟分布——某 P 持续高延迟,可能是锁竞争或 GC STW 影响 - 如果所有 P 的
runq长度都接近 0,但 G 还是不Running,说明问题不在队列排队,而在 P 被抢占或 M 卡住(比如 cgo 调用未释放 P) - 想精确定位某个 G 为何不运行,得在关键位置插入
trace.Log()打标(如 channel 操作前后、锁获取释放点),但避免在 hot path 高频调用,它有明显性能开销
GC 事件也会挤占 trace 空间,大堆内存场景下,trace 文件可能被 GC 记录刷满,goroutine 细节被截断——这不是 bug,是设计取舍。


















