当前位置：首页 > 文章列表 > Golang > Go教程 > Go 数据竞争只在压测出现：把 -race 接入高覆盖测试并读懂报告

Go 数据竞争只在压测出现：把 -race 接入高覆盖测试并读懂报告

来源：17golang原创 2026-09-04 11:39:29 0浏览收藏

如果数据竞争只在压测中出现，先不要把它当成“压测不稳定”。更常见的原因是普通测试没有同时覆盖两个访问者，或者测试虽然启动了 goroutine，却没有让它们真正触达同一份可变状态。把 go test -race 放进高覆盖测试，再按报告里的读写访问栈定位，通常比盯着业务断言更快。

实用结论：-race 只能报告运行过程中实际发生的竞争，所以关键是扩大并发场景覆盖；报告出现后先找同一共享变量的读栈和写栈，再回溯 goroutine 创建位置。修复动作应落在共享状态的同步边界或所有权边界上。

本文要点

用 go test -race ./... 覆盖包级测试，用显式并发用例补足压测才触发的路径。
报告中的读栈、写栈是冲突证据，创建栈用于解释并发来源，三者不要混为一谈。
修复后要重新运行同一组高覆盖测试，并说明仍未被执行到的路径。

先判断：为什么本地测试通过而压测暴露竞争

数据竞争的判定点不是“结果错没错”，而是多个 goroutine 是否在没有合适同步的情况下访问同一内存位置，且至少一方会写。比如一个缓存用普通 map 保存结果，读取请求与刷新请求恰好并发执行，单线程单次测试很容易全部通过；压测改变了调度时机，才让这两个访问重叠。

因此，-race 的适用边界是“可执行路径上的并发内存访问”。它不会证明所有路径都安全，也不会代替业务正确性测试。下面的关系图把测试覆盖边界与共享状态边界分开，便于判断到底是测试没触发，还是代码确实缺少同步。

Go race detector 测试集合与共享缓存 map 的静态关系图
图1：数据竞争的关键不在于某次断言是否通过，而在于多个并发访问者是否共同触达未同步的共享状态。

把 -race 接进高覆盖测试

先在项目根目录执行最小命令：

go test -race ./...

它会重新构建带检测能力的测试程序，然后运行各包测试。若仓库测试本身没有并发场景，还要补一个能稳定制造访问重叠的用例。例如下面的缓存类型把读写都指向同一张 map：

type Cache struct {
    data map[string]string
}

func (c *Cache) Put(key, value string) { c.data[key] = value }
func (c *Cache) Get(key string) string { return c.data[key] }

func TestCacheConcurrentAccess(t *testing.T) {
    c := &Cache{data: make(map[string]string)}
    var wg sync.WaitGroup
    wg.Add(2)
    go func() { defer wg.Done(); c.Put("region", "cn") }()
    go func() { defer wg.Done(); _ = c.Get("region") }()
    wg.Wait()
}

这个例子不是为了依赖某个固定报错顺序，而是为了让读写共享状态进入同一测试窗口。CI 中可以把它作为普通测试的一部分；本地排障时还可以缩小范围：

go test -race -run 'TestCacheConcurrentAccess' ./internal/cache

检测版测试通常会明显变慢并占用更多内存，不能直接拿它的耗时和普通测试做性能结论。更合适的工程做法是：日常提交跑关键高覆盖包，定时任务跑 ./...，大型压测则先用压测请求把可疑路径触发，再回到可重复的测试用例。

读报告时先看两条访问栈

报告以 WARNING: DATA RACE 开头时，先记录它指向的共享变量和源代码行，不要只看最后的退出码。通常会看到一段读访问栈、一段写访问栈，随后各自带有 goroutine 创建信息：

WARNING: DATA RACE
Read at 0x... by goroutine 8:
  ... cache.go:18
Previous write at 0x... by goroutine 7:
  ... cache.go:14
Goroutine 8 (running) created at:
  ... handler_test.go:32
Goroutine 7 (finished) created at:
  ... refresher_test.go:21

读栈和写栈回答“哪两次访问冲突”，创建栈回答“这两个 goroutine 从哪里被启动”。把两条访问栈拉回同一个字段、map 或切片后，再判断应该加互斥锁、使用原子操作、复制数据，还是把状态所有权收回单个 goroutine。不要看到创建栈就直接修改启动代码，它往往只是线索，不是竞态发生的位置。

Go race detector 报告中读写访问栈与 goroutine 创建栈的关系图
图2：读报告先找同一共享变量对应的读写访问栈，再沿 goroutine 创建栈回溯并发来源。

需要把报告分文件保存时，可以设置 GORACE，例如 GORACE="log_path=./race-report strip_path_prefix=$PWD"。日志目录应由 CI 工作区管理，避免把旧报告误当成这次测试的结果；若希望第一次报告就停止，可按官方支持的选项配置 halt_on_error=1。