Go / 系统课时
使用竞态检测器
使用竞态检测器
普通 go test 通过,并不代表并发代码没有数据竞争。本节用一个故意共享未受保护计数器的测试触发 race detector,再根据冲突访问栈追到共享状态来源,完成同步修复并重新验证。
学习目标
- 使用
go test -race在测试运行时检测数据竞争。 - 从
Read、Previous write和 goroutine 创建栈定位冲突访问位置。 - 用同步原语修复共享状态,并再次用 race detector 验证。
先让数据竞争稳定暴露
下面的示例创建四个 goroutine 同时递增同一个 Counter.n。c.n++ 是读、修改、写组成的复合操作,没有同步时,不同 goroutine 会并发访问同一内存位置。
set -eu
tmp_dir="$(mktemp -d)"
trap 'rm -rf "$tmp_dir"' EXIT
cd "$tmp_dir"
go mod init example.com/race >/dev/null 2>&1
cat > counter.go <<'EOF'
package race
type Counter struct {
n int
}
func (c *Counter) Inc() {
c.n++
}
func (c *Counter) Value() int {
return c.n
}
EOF
cat > counter_test.go <<'EOF'
package race
import (
"sync"
"testing"
)
func TestCounterConcurrent(t *testing.T) {
var c Counter
var wg sync.WaitGroup
start := make(chan struct{})
// 用同一个起跑信号提高并发访问重叠概率。
for i := 0; i < 4; i++ {
wg.Add(1)
go func() {
defer wg.Done()
<-start
for j := 0; j < 1000; j++ {
c.Inc()
}
}()
}
close(start)
wg.Wait()
}
EOF
go test -race ./...预期输出(地址、goroutine 编号、路径和行号会变化,但应包含以下关键片段)
WARNING: DATA RACE
Read at <ADDRESS> by goroutine <ID>:
example.com/race.(*Counter).Inc()
<PATH>/counter.go:<LINE>
Previous write at <ADDRESS> by goroutine <ID>:
example.com/race.(*Counter).Inc()
<PATH>/counter.go:<LINE>
--- FAIL: TestCounterConcurrent (<TIME>s)
testing.go:<LINE>: race detected during execution of test
FAIL这里的失败不是普通断言触发的,而是 race detector 观察到两个 goroutine 对同一地址存在未同步且至少一次为写入的并发访问。
从报告追到共享状态
排查时先看第一组冲突访问,而不是从整段日志末尾开始猜。Read at 或 Write at 给出当前访问栈,Previous write at 给出与之冲突的另一条访问栈;两条栈共同指向 Counter.Inc,说明共享字段 n 是交汇点。
随后再看 Goroutine ... created at。它回答“这些并发执行单元从哪里启动”,适合继续追调用链。若报告指向缓存、全局 map、复用缓冲区或测试夹具,同样按“冲突地址 → 两条访问栈 → goroutine 创建位置”的顺序定位。
用互斥锁修复共享访问
这个计数器需要把所有对 n 的访问放进同一同步协议。下面用 sync.Mutex 保护写入和读取;只给写入加锁而让 Value 裸读,在读写并发时仍然会形成数据竞争。
片段示例:以下内容替换 counter.go,依赖前面的 counter_test.go 作为验证入口。
package race
import "sync"
type Counter struct {
mu sync.Mutex
n int
}
func (c *Counter) Inc() {
c.mu.Lock()
c.n++
c.mu.Unlock()
}
func (c *Counter) Value() int {
c.mu.Lock()
defer c.mu.Unlock()
return c.n
}保持前面的 counter_test.go 不变,再执行:
go test -race ./...预期输出
ok example.com/race <TIME>s<TIME> 是动态耗时。修复后的关键标准不是“测试偶尔通过”,而是同一并发测试在开启 -race 后不再出现 DATA RACE 报告。
把 race detector 放进持续测试
-race 会让测试运行更慢、占用更多资源,因此可以把普通单元测试作为快速反馈,把 go test -race ./... 作为独立 CI 任务运行。对于并发密集或刚修改共享状态的包,应该优先纳入每次变更检查,而不是只在故障后手工执行。
race detector 专门发现数据竞争,不等同于并发正确性证明。死锁、活锁、错误的业务顺序,以及通过 channel 或锁实现但逻辑仍然错误的并发行为,可能不会触发它。持续测试的价值在于让动态检测、确定性断言和代码评审各自承担不同职责。