
测试时全局变量被污染,go test 多次运行结果不一致
Go 测试默认并发执行(-p 默认值通常 >1),若测试用例修改了包级变量(如 var Config *Config 或 var cache = make(map[string]string)),后一个测试可能读到前一个测试写入的脏数据。这不是“偶发”,而是确定性发生——只要两个测试改了同一个变量,且没重置,就一定出问题。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 每个测试用例开头用
defer恢复变量原始值,比如orig := globalVar; defer func() { globalVar = orig }() - 避免在
init()或包初始化中写可变状态;把“初始化逻辑”拆成函数,测试中显式调用并传入可控参数 - 对 map/slice 类型全局变量,不要只清空内容(
clear(cache)),还要确保没其他 goroutine 正在读写——更安全的做法是每次测试新建一个实例,通过依赖注入传入
使用 TestMain 重置全局状态,但没处理好并发
TestMain 看似能统一初始化/清理,但它只在所有测试开始前和结束后各执行一次,无法隔离单个测试。如果多个 t.Parallel() 测试共享同一份全局状态,TestMain 的 defer 清理会滞后甚至失效。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 除非必须(如启动/关闭真实 DB 连接),否则别用
TestMain管理可变全局变量 - 真要用,必须配合
sync.Once和sync.RWMutex控制读写,且清理动作不能放在m.Run()后的defer里——应改为每个测试内手动 reset - 更推荐方案:把全局变量封装进结构体,测试中构造新实例,例如
svc := &Service{Cache: make(map[string]int)},彻底摆脱包级变量
依赖第三方库的全局状态(如 log.SetOutput、http.DefaultClient)导致测试串扰
标准库和不少第三方包暴露了可修改的全局句柄。比如一个测试调用了 log.SetOutput(ioutil.Discard),后续测试里的日志就消失了;又或者某测试替换了 http.DefaultClient,影响所有走默认 client 的 HTTP 调用。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 对
log:测试中用log.New创建独立 logger,传给被测函数,而不是动log.Printf - 对
http.Client:被测函数接收*http.Client参数,测试时传入&http.Client{Transport: &mockRoundTripper{}} - 对
time.Now这类隐式依赖:定义type Clock interface { Now() time.Time },默认实现返回time.Now(),测试时注入固定时间的 mock
Go 1.21+ 的 testing.T.Cleanup 没覆盖所有场景
Cleanup 确实比 defer 更可靠(它保证在子测试结束时也执行),但它只对当前 *testing.T 生效。如果测试中启了 goroutine,而 goroutine 在测试结束后才写全局变量,Cleanup 就拦不住。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 所有异步操作必须显式同步:用
sync.WaitGroup或chan struct{}等待 goroutine 完成后再让测试结束 - 禁止在 goroutine 中直接修改包级变量;如需通信,改用 channel 或回调函数传回结果
- 对定时器(
time.AfterFunc、time.Tick)务必在Cleanup中Stop(),否则它们可能在下次测试中意外触发
全局变量测试隔离的本质不是“怎么清掉”,而是“让它根本不需要被共享”。最省心的方案永远是:不暴露可变全局状态,把状态变成参数或结构体字段。一旦开始写 resetGlobalXxx(),说明设计已经往脆弱方向偏了。










