Go / 系统课时
管理测试缓存与重复执行
管理测试缓存与重复执行
go test 可能真实执行测试,也可能复用之前的成功结果。排查“是否真的重跑”时,要同时理解缓存命中、显式禁用缓存和 -count 重复执行。本节用时间戳观察 (cached),并建立本地调试与稳定性验证的可靠命令习惯。
学习目标
- 判断
go test输出来自真实执行还是成功结果缓存。 - 使用
-count=1和go clean -testcache控制缓存行为。 - 用
-count=N做真实重复执行,并避免把缓存命中误判为稳定性证据。
用可观察输出识别缓存
在 package list mode 下,例如 go test .、go test ./...,Go 可以缓存成功的包测试结果。命中缓存时,包结果末尾会显示 (cached);缓存的测试输出也可能被重放,所以仅看到 t.Log 并不能证明代码刚刚执行。
先建立一个最小 module:
mkdir cache-demo
cd cache-demo
go mod init example/cache-demo预期输出:
go: creating new go.mod: module example/cache-demo新建 cache_test.go:
package cachedemo
import (
"testing"
"time"
)
func TestCacheProbe(t *testing.T) {
// 时间戳用于观察测试体是否真的再次执行。
t.Logf("executed at %s", time.Now().UTC().Format(time.RFC3339Nano))
}预期结果:文件可正常编译;真正是否重新执行,要通过下面两次 package list mode 测试比较。
第一次执行:
go test -v .预期输出类似:
=== RUN TestCacheProbe
cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok example/cache-demo <TIME>不修改源码,再执行完全相同的命令:
go test -v .预期输出会复用成功结果,末尾出现 (cached);日志中的执行时间也可能与第一次完全相同:
=== RUN TestCacheProbe
cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok example/cache-demo (cached)因此判断“是否真实执行”的首要信号是包结果里的 (cached),而不是测试日志有没有出现。
显式要求真实执行
调试、验证环境变量变化或确认偶发问题时,最直接的做法是显式传入 -count=1。虽然默认计数也是一次,但显式的 -count=1 会关闭测试结果缓存。
go test -count=1 -v .预期输出与第一次运行结构相同,但会重新生成当前时间,不出现 (cached):
=== RUN TestCacheProbe
cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok example/cache-demo <TIME>如果需要清空已有测试结果缓存,可以执行:
go clean -testcache
go test -v .预期结果:go clean -testcache 成功时通常没有输出;紧接着的测试会真实执行一次,包结果不会标记 (cached)。
用 -count 做重复执行
-count=N 不只是“绕过缓存”,还会让每个测试和基准按指定次数重复运行,因此适合验证可重复性。下面只重复当前探针测试五次:
go test -run '^TestCacheProbe$' -count=5 -v .预期输出会出现五轮 RUN 与 PASS,每轮都是真实执行,因此时间戳应各自对应实际运行时刻,末尾也不会是 (cached):
=== RUN TestCacheProbe
<TEST_LOG>
--- PASS: TestCacheProbe (<TIME>)
=== RUN TestCacheProbe
<REPEATED_RUNS>
--- PASS: TestCacheProbe (<TIME>)
<REPEATED_RUNS>
PASS
ok example/cache-demo <TIME>重复次数越大,总耗时也越接近线性增加。对依赖外部数据库、网络或昂贵初始化的测试,不要机械地把 -count 调得很高;先缩小到目标包或目标测试,再逐步增加次数,能更快获得有效证据。
避免把缓存命中当成稳定性证明
-run 用来筛选测试,但它本身不等于“强制重跑”。当命令仍满足缓存条件时,成功结果可能继续被复用,所以验证某个修复是否稳定时,应把筛选与重复执行组合起来,例如 go test -run '^TestName$' -count=20 .。
测试缓存适合缩短日常反馈时间,重复执行适合验证确定性,两者目标不同。日常开发可以接受缓存带来的速度收益;排查 Flaky Test、验证时间敏感逻辑或确认测试体确实执行时,则应显式使用 -count=1 或更大的重复次数,并从输出中的 (cached) 判断自己拿到的是缓存结果还是真实运行结果。