Go / 系统课时

使用竞态检测器

使用竞态检测器

普通 go test 通过,并不代表并发代码没有数据竞争。本节用一个故意共享未受保护计数器的测试触发 race detector,再根据冲突访问栈追到共享状态来源,完成同步修复并重新验证。

学习目标

  • 使用 go test -race 在测试运行时检测数据竞争。
  • 从 Read、Previous write 和 goroutine 创建栈定位冲突访问位置。
  • 用同步原语修复共享状态,并再次用 race detector 验证。

先让数据竞争稳定暴露

下面的示例创建四个 goroutine 同时递增同一个 Counter.n。c.n++ 是读、修改、写组成的复合操作,没有同步时,不同 goroutine 会并发访问同一内存位置。

bash
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 编号、路径和行号会变化,但应包含以下关键片段)

text
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 作为验证入口。

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 不变,再执行:

bash
go test -race ./...

预期输出

text
ok  	example.com/race	<TIME>s

<TIME> 是动态耗时。修复后的关键标准不是“测试偶尔通过”,而是同一并发测试在开启 -race 后不再出现 DATA RACE 报告。

把 race detector 放进持续测试

-race 会让测试运行更慢、占用更多资源,因此可以把普通单元测试作为快速反馈,把 go test -race ./... 作为独立 CI 任务运行。对于并发密集或刚修改共享状态的包,应该优先纳入每次变更检查,而不是只在故障后手工执行。

race detector 专门发现数据竞争,不等同于并发正确性证明。死锁、活锁、错误的业务顺序,以及通过 channel 或锁实现但逻辑仍然错误的并发行为,可能不会触发它。持续测试的价值在于让动态检测、确定性断言和代码评审各自承担不同职责。

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

目录与阅读设置

记录一个想法

使用竞态检测器

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

登录哪都通