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:

bash
mkdir cache-demo
cd cache-demo
go mod init example/cache-demo

预期输出:

text
go: creating new go.mod: module example/cache-demo

新建 cache_test.go:

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 测试比较。

第一次执行:

bash
go test -v .

预期输出类似:

text
=== RUN   TestCacheProbe
    cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok  	example/cache-demo	<TIME>

不修改源码,再执行完全相同的命令:

bash
go test -v .

预期输出会复用成功结果,末尾出现 (cached);日志中的执行时间也可能与第一次完全相同:

text
=== RUN   TestCacheProbe
    cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok  	example/cache-demo	(cached)

因此判断“是否真实执行”的首要信号是包结果里的 (cached),而不是测试日志有没有出现。

显式要求真实执行

调试、验证环境变量变化或确认偶发问题时,最直接的做法是显式传入 -count=1。虽然默认计数也是一次,但显式的 -count=1 会关闭测试结果缓存。

bash
go test -count=1 -v .

预期输出与第一次运行结构相同,但会重新生成当前时间,不出现 (cached):

text
=== RUN   TestCacheProbe
    cache_test.go:<LINE>: executed at <TIME>
--- PASS: TestCacheProbe (<TIME>)
PASS
ok  	example/cache-demo	<TIME>

如果需要清空已有测试结果缓存,可以执行:

bash
go clean -testcache
go test -v .

预期结果:go clean -testcache 成功时通常没有输出;紧接着的测试会真实执行一次,包结果不会标记 (cached)。

用 -count 做重复执行

-count=N 不只是“绕过缓存”,还会让每个测试和基准按指定次数重复运行,因此适合验证可重复性。下面只重复当前探针测试五次:

bash
go test -run '^TestCacheProbe$' -count=5 -v .

预期输出会出现五轮 RUN 与 PASS,每轮都是真实执行,因此时间戳应各自对应实际运行时刻,末尾也不会是 (cached):

text
=== 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) 判断自己拿到的是缓存结果还是真实运行结果。

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

目录与阅读设置

记录一个想法

管理测试缓存与重复执行

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

登录哪都通