17370845950

Go测试互相影响的本质是状态泄漏，需通过-p=1串行化包执行、构建标签隔离集成测试、每个测试独立管理资源（如临时目录、数据库连接）及t.Run分隔子测试来解决。

Go测试互相影响，本质是状态泄漏——不是代码写错了，而是没管住共享资源。最常见表现：前一个测试删了数据库表，后一个测试建表失败；或全局变量被改了值，导致后续测试断言失败。解决思路很直接：切断共享、控制边界、分层隔离。

用 -p=1 强制包级串行，解决跨包数据库冲突

多个包（比如 ./pkg/user 和 ./pkg/order）各自跑 go test 时都重置数据库，但默认并行执行会让它们抢同一套 DB 连接和 schema，报错如 ERROR: relation "users" does not exist。

• -p=1 是唯一能真正串行化「包之间」执行的标志——它让 go test 一次只构建并运行一个包，等它全部 test 完再切到下一个
• -parallel 0 或 -cpu 1 没用：它们只控制「单个包内」测试函数的并发，不阻止包间并行
• 适用场景：所有依赖共享外部资源（PostgreSQL/Redis/临时目录）的集成测试包

go test -p=1 ./pkg/...

用构建标签（//go:build integration）分离单元与集成测试

单元测试不该碰数据库，但又不能删掉集成测试代码——用构建标签物理隔离才是正解。否则 go test ./... 会把所有 *_test.go 全塞进同一个编译上下文，全局变量、init 函数、DB 连接池全混在一起。

• 给集成测试文件加标签：

  //go:build integration
  package user
  
  func TestInsertWithDB(t *testing.T) { ... }

• 运行时显式选择：go test . 只跑单元测试；go test --tags=integration . 才加载集成测试
• 避免用环境变量做开关：它无法阻止编译期初始化（比如 init() 里连 DB），而构建标签在编译阶段就剔除了无关文件

每个测试用例自己管好自己的状态，别信 init() 和全局变量

Go 测试文件被导入时，init() 会执行一次；如果多个测试文件 import 同一个工具包，它的 init() 就可能被多次触发，或者状态残留。更糟的是，go test 在单次进程里复用解释器，全局变量不会自动清空。

• 临时文件必须配 defer os.RemoveAll(tempDir)，且路径用 os.MkdirTemp("", "test-*") 动态生成
• 数据库连接不要复用全局 *sql.DB，每次测试用 setupTestDB() 创建新连接 + defer db.Close()
• 绝对不要在 init() 里初始化任何可变状态（如计数器、缓存 map、HTTP client transport）
• Yaegi 等解释器场景下，更要为每个测试启动独立实例——文件级隔离靠的是进程/解释器边界，不是函数作用域

表驱动测试里用 t.Run() 建子测试，别堆在同一个函数里

看起来只是语法糖，实则关系到失败定位和资源清理。把 10 个 case 写在一个 TestXxx 函数里，一旦第 5 个 panic，你根本不知道是哪个 case 触发的；而且 defer 会在整个函数结束才执行，前面 case 创建的资源可能干扰后面 case。

• 每个 case 必须包在 t.Run("case_name", func(t *testing.T) { ... }) 里
• t.Run 提供独立的 t 实例，defer 只对当前子测试生效
• 名字要有信息量，比如 "empty_input_returns_error" 而不是 "case1"

func TestParse(t *testing.T) {
    tests := []struct{
        input string
        want  error
    }{
        {"", fmt.Errorf("empty")},
        {"123", nil},
    }
    for _, tt := range tests {
        tt := tt // 防止闭包引用问题
        t.Run(tt.input, func(t *testing.T) {
            got := Parse(tt.input)
            if !errors.Is(got, tt.want) {
                t.Fatalf("Parse(%q) = %v, want %v", tt.input, got, tt.want)
            }
        })
    }
}

最难防的不是写错，而是忘了“测试本身也是程序”——它会读文件、连网络、改全局变量、复用内存。隔离不是加个 flag 就完事，得从资源生命周期、编译边界、运行时作用域三层去卡。尤其是 -p=1 和构建标签，很多人试过 -parallel 0 失败就放弃了，其实根本没打到要害上。