Go / 系统课时

控制并行测试共享状态

控制并行测试共享状态

并行子测试能显著缩短测试时间,但也会把隐蔽的共享变量、全局状态和顺序依赖放大成数据竞争或偶发失败。本课用一个可运行示例建立安全边界:能隔离的状态留在子测试内部,必须共享的状态用同步保护,并用分组等待保证验证时机正确。

学习目标

  • 识别 t.Parallel() 下会被多个子测试同时读写的共享状态
  • 用局部副本、互斥锁和测试分组消除数据竞争与时序假设
  • 使用 go test -race 验证并行测试没有未受保护的并发访问

并行子测试真正共享了什么

子测试调用 t.Parallel() 后会先暂停;父测试函数返回后,它才与同组其他并行测试一起恢复执行。因此多个子测试可能同时访问同一进程内的包级变量、父函数中的引用类型、外部文件、测试替身或其他可变资源。

最危险的不是“并行”本身,而是可变状态被多个执行单元共同持有。例如多个子测试向同一个 map 写入或修改同一个包级计数器,都会让结果依赖调度时机。t.Setenv() 修改的是进程级环境,因此测试框架也禁止它在并行测试或具有并行祖先的测试中使用。

并行子测试共享状态与隔离边界

用隔离和同步控制共享状态

下面的测试把每个用例复制到子测试局部变量中,计算结果只保存在局部 got 中;只有汇总 results 需要共享,因此用 sync.Mutex 保护。外层再包一层 parallel-cases,确保该分组返回时所有并行子测试都已经结束,随后再检查汇总结果。

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

bash
go test -race -run '^TestDoubleParallel$'

预期输出

text
PASS
ok      <PACKAGE>      <TIME>

包路径和耗时会因项目而异;关键是命令以 PASS 结束,并且 -race 不出现 WARNING: DATA RACE。

不要把执行顺序当成测试契约

并行测试不应依赖“one 一定先于 two 完成”这类假设。若业务本身需要固定顺序,那部分逻辑应放在同一个顺序测试中,而不是用并行子测试再通过睡眠或轮询强行排序。time.Sleep 只能改变概率,不能建立同步关系。

还要谨慎处理进程级状态。包级变量、当前工作目录、固定临时文件名等资源都可能让不同测试互相污染。优先使用局部变量、t.TempDir() 和每个用例独立的资源;确实需要共享时,再使用互斥锁、通道或其他明确同步机制。

最终判断标准不是“多跑几次没失败”,而是共享边界清晰、没有顺序依赖,并且 go test -race 能稳定通过。这样并行测试才是在提升速度,而不是把不稳定性藏进调度器里。

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

目录与阅读设置

记录一个想法

控制并行测试共享状态

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

登录哪都通