Go / 系统课时
使用 Race Detector 发现数据竞争
使用 Race Detector 发现数据竞争
这一课用一个可复现的共享计数器竞态,演示如何通过 go test -race 找到未同步读写,并从报告中的访问栈和 goroutine 创建栈回到源码。最后再用原子操作消除竞态,验证“结果偶尔正确”不等于并发访问安全。
学习目标
- 能用
go test -race复现并定位真实数据竞争。 - 能从 Race Detector 报告中识别冲突访问、调用栈和 goroutine 来源。
- 能区分数据竞争、业务逻辑错误以及“本次没有检测到竞争”。
Race Detector 实际检测什么
数据竞争指多个 goroutine 对同一内存位置发生并发访问,其中至少一个是写操作,并且这些访问之间没有由锁、Channel、原子操作等建立同步顺序。普通测试只检查结果,Race Detector 则会在运行时记录内存访问与同步事件,寻找这种未排序的冲突访问。

Race Detector 是动态检测器:代码必须真的执行到相关路径,它才有机会发现问题。因此一次 -race 通过只能说明“这次覆盖到的执行没有观察到数据竞争”,不能证明程序永远没有竞争。
复现一个未同步计数器
将下面的完整测试保存为 counter_test.go。两个 goroutine 都执行 counter++;这个表达式本身包含读、加一、写回三个动作,没有任何同步保护。
package raceexample
import (
"sync"
"testing"
)
func TestCounterRace(t *testing.T) {
var counter int
var wg sync.WaitGroup
wg.Add(2)
for i := 0; i < 2; i++ {
go func() {
defer wg.Done()
for j := 0; j < 1000; j++ {
// 两个 goroutine 会无同步地读写同一个 counter。
counter++
}
}()
}
wg.Wait()
t.Logf("counter=%d", counter)
}预期结果:该文件可以作为独立测试源编译;普通测试即使偶尔得到看似合理的计数,也不能据此判断访问安全。使用 Race Detector 执行:
go test -race counter_test.go预期输出会包含 WARNING: DATA RACE,具体地址、路径、行号、goroutine 编号和耗时会因环境不同而变化:
WARNING: DATA RACE
Read at 0x<VALUE> by goroutine <ID>:
command-line-arguments.TestCounterRace.func1()
<PATH>/counter_test.go:<LINE>
Previous write at 0x<VALUE> by goroutine <ID>:
command-line-arguments.TestCounterRace.func1()
<PATH>/counter_test.go:<LINE>
--- FAIL: TestCounterRace (<TIME>s)
FAIL从报告回到根因
阅读竞态报告时,不要先盯着最终 FAIL,而要按证据顺序定位。
- 先确认两段冲突访问是否指向同一共享对象;
Read、Write或Previous write表明各自的访问类型。 - 查看每段访问栈最靠近业务代码的文件和行号,找到实际发生读写的位置。
- 再看
Goroutine ... created at,确认这些访问由哪些并发入口创建,判断应该在哪个共享边界建立同步。
在这个例子里,两条栈最终都落到 counter++。WaitGroup 只保证主测试等待两个 goroutine 结束,它并没有给两个 goroutine 之间的每次计数访问建立互斥关系,所以不能消除数据竞争。
修复后再次验证
如果共享状态只需要原子地累加一个整数,可以直接用 sync/atomic,避免引入更大的临界区。将下面的完整版本保存为 counter_fixed_test.go。它仍然使用同一测试结构,只替换共享计数器的同步方式。
package raceexample
import (
"sync"
"sync/atomic"
"testing"
)
func TestCounterAtomic(t *testing.T) {
var counter atomic.Int64
var wg sync.WaitGroup
wg.Add(2)
for i := 0; i < 2; i++ {
go func() {
defer wg.Done()
for j := 0; j < 1000; j++ {
// Add 同时完成读取、计算和写回,不暴露未同步的中间状态。
counter.Add(1)
}
}()
}
wg.Wait()
if got := counter.Load(); got != 2000 {
t.Fatalf("counter=%d, want 2000", got)
}
}执行修复后的测试:
go test -race counter_fixed_test.go预期输出不再出现竞态警告:
ok command-line-arguments <TIME>s原子操作只适合单个值上的简单原子状态变更。如果多个字段必须保持共同不变量,应使用能够覆盖整个临界区的同步方案,而不是把每个字段分别改成原子变量。
不要把 -race 当成完整正确性证明
Race Detector 擅长发现未同步内存访问,但它不会替你证明业务顺序正确,也不能自动发现所有死锁、重复提交、丢消息或逻辑上的检查后执行错误。相反,检测到数据竞争本身就是必须修复的并发缺陷,即使当前测试输出看起来完全正常。
实际项目中应把 go test -race ./... 放进并发相关改动的验证流程,并让测试、集成场景和压力用例尽量覆盖真实并发路径。由于 -race 会显著增加运行成本,它更适合测试和诊断环境,而不是作为生产进程的常态运行模式。