Go testing.T Cleanup 如何保证测试资源按逆序释放

测试里同时打开连接、创建事务和准备临时文件时，真正容易出错的不是“有没有清理”，而是“谁先清理”。直接结论是：同一个 *testing.T 上多次调用 Cleanup，执行顺序是后注册先执行；当前测试的清理还会等自己的子测试全部结束。把依赖较深的资源后注册，就能让它先释放。

官方文档：https://pkg.go.dev/testing

Cleanup 解决的是哪一段生命周期

defer 在当前 Go 函数返回时执行，适合函数内部的局部资源；t.Cleanup 则把清理动作交给测试框架管理。它会在当前测试及其所有子测试完成后调用，且同一测试对象上的回调遵循“最后添加、最先调用”。这个能力从 Go 1.14 开始提供。

所以，夹具函数可以接收 t *testing.T，在资源准备成功后立刻登记回收动作。即使后面调用 Fatal 或测试失败，测试框架仍能走到已登记的 Cleanup；但清理函数本身不要再依赖一个已经被提前关闭的资源。

同一个测试对象里，清理顺序按注册顺序倒放

假设连接是最底层资源，事务依赖连接，临时文件是本用例最后创建的辅助资源。登记时按创建顺序写，释放时自然倒序：

func TestCleanupOrder(t *testing.T) {
	// 先登记底层连接，后面的事务清理可以安全依赖它。
	t.Cleanup(func() { t.Log("close connection") })

	// 事务在连接之上，按创建层级继续登记。
	t.Cleanup(func() { t.Log("rollback transaction") })

	// 临时文件最后创建，因此会在清理阶段最先处理。
	t.Cleanup(func() { t.Log("remove temporary file") })
}

这里不要为了“看起来整齐”把清理回调集中到函数末尾。资源一旦创建成功就登记，后续初始化失败时也能保留已经完成的清理链。若某项资源没有创建成功，就不要登记一个会对空句柄操作的回调，或者让回调显式判断初始化状态。

父测试和子测试各自管理自己的 Cleanup

父子测试不是共享一个隐形的清理栈。每个 *testing.T 都有自己的注册边界：子测试结束后先执行子测试的 Cleanup，随后 t.Run 返回，父测试才进入自己的清理阶段。

func TestParentAndChild(t *testing.T) {
	// 父测试负责整个测试组都需要的根资源。
	t.Cleanup(func() { t.Log("parent: root") })
	t.Cleanup(func() { t.Log("parent: db") })

	t.Run("case", func(t *testing.T) {
		// 子测试只登记自己创建的资源，避免重复关闭父级资源。
		t.Cleanup(func() { t.Log("child: file") })
		t.Cleanup(func() { t.Log("child: cache") })
	})
}

按文档语义，结果示意顺序是 child: cache、child: file、parent: db、parent: root。这条边界很适合设计测试夹具：父级放共享数据库或服务，子级放单用例文件和缓存。子级不要把父级资源的关闭动作再注册一遍。

失败路径和并行测试要检查什么

用 t.Cleanup 并不等于所有资源都可以随便共享。为每个测试创建的文件、连接和客户端，优先由创建它的那个 T 负责释放；会改变整个进程状态的环境变量、工作目录等，则不要在并行测试及其并行祖先中随意修改。需要并行子测试时，把共享资源的生命周期放在父测试，并确保父级 Cleanup 只在所有子测试用完后才关闭。

• 创建成功后立即登记，避免中途 Fatal 留下半成品资源。
• 清理回调保持幂等，失败重试或多层夹具调用时不要重复提交危险操作。
• 回调里记录资源名和错误；不要静默吞掉真正影响后续用例的释放失败。
• 先画出“谁依赖谁”，再决定注册顺序：底层先创建、先登记，最后释放。

相关问题

t.Cleanup 会在测试失败后执行吗？

已注册的清理函数由 testing 框架在测试收尾阶段调用，失败或跳过不能成为不登记资源的理由；清理函数自身仍要处理关闭错误和未初始化状态。

Cleanup 和 defer 应该怎么选？

只服务当前函数的局部值用 defer；需要覆盖测试失败、子测试或夹具复用时用 t.Cleanup。两者可以同时存在，但应明确各自的所有权。

为什么清理顺序看起来“反了”？

这是设计行为，不是随机执行：同一个 T 按后注册先执行。按资源创建和依赖顺序登记，释放时就会得到稳定的逆序。