Go / 系统课时
使用 Mutex 与 Block Profile
使用 Mutex 与 Block Profile
Mutex Profile 和 Block Profile 都用于回答“时间为什么耗在等待上”,但观察角度不同:前者追踪互斥锁竞争的持有方,后者记录 goroutine 在同步原语上的阻塞位置。本课用一个可重复测试生成两类 Profile,并建立从热点到源码修复的判读顺序。
学习目标
- 区分 Mutex Profile 与 Block Profile 的采样对象和堆栈含义。
- 使用
go test采集互斥竞争与阻塞 Profile,并用go tool pprof定位热点。 - 根据锁、Channel 与其他同步等待的证据选择修复方向,避免把调度问题误判为锁问题。
先区分两个 Profile
Mutex Profile 关注“谁让别人等锁”。它统计发生竞争的 sync.Mutex、sync.RWMutex 以及部分运行时内部锁;堆栈指向造成竞争的临界区结束位置,通常会落在 Unlock 一侧。因此它更适合回答:哪段临界区持锁太久、哪个锁形成热点。
Block Profile 关注“goroutine 在哪里被同步原语阻塞”。它可覆盖 Mutex、RWMutex、WaitGroup、Cond、Channel 发送/接收和 select 等等待;堆栈对应实际发生阻塞的位置。一个锁竞争问题可能同时出现在两份 Profile 中,但两者分别提供持有方与等待方视角。

生成可重复的竞争样本
下面的测试同时制造互斥锁竞争与无缓冲 Channel 等待。保存为 profile_test.go,在一个空目录中执行即可;测试代码没有依赖第三方包。
package profiletest
import (
"sync"
"testing"
"time"
)
func TestContention(t *testing.T) {
var mu sync.Mutex
var wg sync.WaitGroup
// 多个 goroutine 在临界区内短暂休眠,稳定制造同一把锁的竞争。
for i := 0; i < 8; i++ {
wg.Add(1)
go func() {
defer wg.Done()
for j := 0; j < 200; j++ {
mu.Lock()
time.Sleep(100 * time.Microsecond)
mu.Unlock()
}
}()
}
ch := make(chan struct{})
wg.Add(2)
go func() {
defer wg.Done()
for i := 0; i < 200; i++ {
time.Sleep(100 * time.Microsecond)
ch <- struct{}{}
}
}()
go func() {
defer wg.Done()
for i := 0; i < 200; i++ {
time.Sleep(200 * time.Microsecond)
<-ch
}
}()
wg.Wait()
}执行测试并同时输出两份 Profile。这里把采样率调到最细是为了教学实验;线上长期运行时应降低采样强度并评估开销。
go mod init example.com/profiletest
go test -run '^TestContention$' -count=1 -mutexprofile=mutex.out -mutexprofilefraction=1 -blockprofile=block.out -blockprofilerate=1预期输出:
go: creating new go.mod: module example.com/profiletest
PASS
ok example.com/profiletest <TIME><TIME> 会随机器变化,同时当前目录会生成 go.mod、mutex.out、block.out 以及测试二进制文件。
用 pprof 读出热点
先查看 Mutex Profile。top 的重点不是某个绝对纳秒值,而是累计竞争时间是否集中在少数调用路径;随后用 list 回到具体临界区。
go tool pprof -top mutex.out
go tool pprof -list TestContention mutex.out预期结果:
Type: delay
Showing nodes accounting for <VALUE>, <VALUE>% of <VALUE> total
...
<VALUE> <VALUE>% ... sync.(*Mutex).Unlock
...
ROUTINE ======================== <PACKAGE>.TestContention.func1
...再查看 Block Profile。这个测试通常会同时出现锁等待、Channel 发送或接收等待,以及 WaitGroup.Wait;具体占比受调度和机器负载影响。
go tool pprof -top block.out预期结果:
Type: delay
Showing nodes accounting for <VALUE>, <VALUE>% of <VALUE> total
...
<VALUE> <VALUE>% ... sync.(*Mutex).Lock
<VALUE> <VALUE>% ... runtime.chanrecv1
<VALUE> <VALUE>% ... sync.(*WaitGroup).Wait这些 <VALUE> 是采样得到的动态值。判读时先看累计等待时间,再看调用路径是否属于请求热路径,最后回到源码确认临界区和同步协议。
从证据决定修复方向
Mutex Profile 集中在某个 Unlock 路径时,优先缩短临界区:把 I/O、序列化、日志或可并行计算移出锁外;若不同数据彼此独立,再考虑分片锁或改变数据所有权。不要仅凭“锁函数在 top 中出现”就机械替换成 RWMutex。
Block Profile 若集中在 Channel 发送,说明生产速度可能长期高于消费速度,或消费者已退出;集中在接收,则检查生产者是否遗漏发送或关闭。WaitGroup.Wait 很高时,要继续追踪哪些 goroutine 没有按预期结束,而不是优化 Wait 本身。
当 Mutex Profile 能指出“谁持锁太久”,Block Profile 能指出“谁在哪里等待”,两份证据就能把“服务变慢”收敛为可修改的同步路径;如果主要问题是 runnable goroutine 的排队或抢占,则应切换到 execution trace,而不是继续加大阻塞采样。