Go / 系统课时
控制并行测试共享状态
控制并行测试共享状态
并行子测试能显著缩短测试时间,但也会把隐蔽的共享变量、全局状态和顺序依赖放大成数据竞争或偶发失败。本课用一个可运行示例建立安全边界:能隔离的状态留在子测试内部,必须共享的状态用同步保护,并用分组等待保证验证时机正确。
学习目标
- 识别
t.Parallel()下会被多个子测试同时读写的共享状态 - 用局部副本、互斥锁和测试分组消除数据竞争与时序假设
- 使用
go test -race验证并行测试没有未受保护的并发访问
并行子测试真正共享了什么
子测试调用 t.Parallel() 后会先暂停;父测试函数返回后,它才与同组其他并行测试一起恢复执行。因此多个子测试可能同时访问同一进程内的包级变量、父函数中的引用类型、外部文件、测试替身或其他可变资源。
最危险的不是“并行”本身,而是可变状态被多个执行单元共同持有。例如多个子测试向同一个 map 写入或修改同一个包级计数器,都会让结果依赖调度时机。t.Setenv() 修改的是进程级环境,因此测试框架也禁止它在并行测试或具有并行祖先的测试中使用。

用隔离和同步控制共享状态
下面的测试把每个用例复制到子测试局部变量中,计算结果只保存在局部 got 中;只有汇总 results 需要共享,因此用 sync.Mutex 保护。外层再包一层 parallel-cases,确保该分组返回时所有并行子测试都已经结束,随后再检查汇总结果。
package parallelstate
import (
"sync"
"testing"
)
func TestDoubleParallel(t *testing.T) {
cases := []struct {
name string
input int
want int
}{
{name: "one", input: 1, want: 2},
{name: "two", input: 2, want: 4},
{name: "three", input: 3, want: 6},
}
results := make(map[string]int, len(cases))
var mu sync.Mutex
t.Run("parallel-cases", func(t *testing.T) {
for _, tc := range cases {
// 明确每个子测试持有自己的用例副本,也兼容旧版 range 变量语义。
tc := tc
t.Run(tc.name, func(t *testing.T) {
t.Parallel()
got := tc.input * 2
if got != tc.want {
t.Fatalf("got %d, want %d", got, tc.want)
}
// map 会被多个并行子测试写入,必须同步。
mu.Lock()
results[tc.name] = got
mu.Unlock()
})
}
})
// group 返回时,其并行子测试已完成,此时再读取汇总结果。
if len(results) != len(cases) {
t.Fatalf("got %d results, want %d", len(results), len(cases))
}
}将代码保存为当前 Go 模块中的 parallel_state_test.go,然后执行:
go test -race -run '^TestDoubleParallel$'预期输出
PASS
ok <PACKAGE> <TIME>包路径和耗时会因项目而异;关键是命令以 PASS 结束,并且 -race 不出现 WARNING: DATA RACE。
不要把执行顺序当成测试契约
并行测试不应依赖“one 一定先于 two 完成”这类假设。若业务本身需要固定顺序,那部分逻辑应放在同一个顺序测试中,而不是用并行子测试再通过睡眠或轮询强行排序。time.Sleep 只能改变概率,不能建立同步关系。
还要谨慎处理进程级状态。包级变量、当前工作目录、固定临时文件名等资源都可能让不同测试互相污染。优先使用局部变量、t.TempDir() 和每个用例独立的资源;确实需要共享时,再使用互斥锁、通道或其他明确同步机制。
最终判断标准不是“多跑几次没失败”,而是共享边界清晰、没有顺序依赖,并且 go test -race 能稳定通过。这样并行测试才是在提升速度,而不是把不稳定性藏进调度器里。