Go / 系统课时

使用 Race Detector 发现数据竞争

使用 Race Detector 发现数据竞争

这一课用一个可复现的共享计数器竞态,演示如何通过 go test -race 找到未同步读写,并从报告中的访问栈和 goroutine 创建栈回到源码。最后再用原子操作消除竞态,验证“结果偶尔正确”不等于并发访问安全。

学习目标

  • 能用 go test -race 复现并定位真实数据竞争。
  • 能从 Race Detector 报告中识别冲突访问、调用栈和 goroutine 来源。
  • 能区分数据竞争、业务逻辑错误以及“本次没有检测到竞争”。

Race Detector 实际检测什么

数据竞争指多个 goroutine 对同一内存位置发生并发访问,其中至少一个是写操作,并且这些访问之间没有由锁、Channel、原子操作等建立同步顺序。普通测试只检查结果,Race Detector 则会在运行时记录内存访问与同步事件,寻找这种未排序的冲突访问。

Race Detector 从并发内存访问到竞态报告的定位链路

Race Detector 是动态检测器:代码必须真的执行到相关路径,它才有机会发现问题。因此一次 -race 通过只能说明“这次覆盖到的执行没有观察到数据竞争”,不能证明程序永远没有竞争。

复现一个未同步计数器

将下面的完整测试保存为 counter_test.go。两个 goroutine 都执行 counter++;这个表达式本身包含读、加一、写回三个动作,没有任何同步保护。

go
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 执行:

bash
go test -race counter_test.go

预期输出会包含 WARNING: DATA RACE,具体地址、路径、行号、goroutine 编号和耗时会因环境不同而变化:

text
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,而要按证据顺序定位。

  1. 先确认两段冲突访问是否指向同一共享对象;Read、Write 或 Previous write 表明各自的访问类型。
  2. 查看每段访问栈最靠近业务代码的文件和行号,找到实际发生读写的位置。
  3. 再看 Goroutine ... created at,确认这些访问由哪些并发入口创建,判断应该在哪个共享边界建立同步。

在这个例子里,两条栈最终都落到 counter++。WaitGroup 只保证主测试等待两个 goroutine 结束,它并没有给两个 goroutine 之间的每次计数访问建立互斥关系,所以不能消除数据竞争。

修复后再次验证

如果共享状态只需要原子地累加一个整数,可以直接用 sync/atomic,避免引入更大的临界区。将下面的完整版本保存为 counter_fixed_test.go。它仍然使用同一测试结构,只替换共享计数器的同步方式。

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)
	}
}

执行修复后的测试:

bash
go test -race counter_fixed_test.go

预期输出不再出现竞态警告:

text
ok  	command-line-arguments	<TIME>s

原子操作只适合单个值上的简单原子状态变更。如果多个字段必须保持共同不变量,应使用能够覆盖整个临界区的同步方案,而不是把每个字段分别改成原子变量。

不要把 -race 当成完整正确性证明

Race Detector 擅长发现未同步内存访问,但它不会替你证明业务顺序正确,也不能自动发现所有死锁、重复提交、丢消息或逻辑上的检查后执行错误。相反,检测到数据竞争本身就是必须修复的并发缺陷,即使当前测试输出看起来完全正常。

实际项目中应把 go test -race ./... 放进并发相关改动的验证流程,并让测试、集成场景和压力用例尽量覆盖真实并发路径。由于 -race 会显著增加运行成本,它更适合测试和诊断环境,而不是作为生产进程的常态运行模式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Race Detector 发现数据竞争

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通