Go testing.T.Cleanup 如何观察子测试退出后的清理顺序

在表驱动测试里，父测试通常负责准备共享资源，t.Run 再拆出多个子场景。真正容易混淆的是：子测试结束时，哪些清理函数已经执行，父测试的清理又会落在哪里？

结论很明确：t.Cleanup 注册的函数，会等当前测试以及它的所有子测试完成后执行；同一个测试节点上，后注册的回调先执行。要观察顺序，给回调加上 t.Name() 和稳定标签即可，不要把它和普通函数里的 defer 混为一谈。

先看清 t.Run 返回点和 Cleanup 执行点

t.Run 建立了测试层级。非并行子测试结束后，父测试会继续执行；并行子测试则要等到它们完成，父级的后续收尾才有安全边界。t.Cleanup 的触发点更靠后：它服务的是“当前测试和全部子测试都完成”这一生命周期节点。

这一区分决定了资源应该交给谁释放：子测试独占的临时目录放在子测试里注册，整个测试组共用的客户端或服务替身放在父测试里注册。

testing.T.Cleanup 的注册顺序为什么是后进先出

可以把每个 *testing.T 想成拥有自己的清理栈。第一次注册的回调在栈底，第二次注册的回调压在它上面，因此同一测试节点遵循 last added, first called。下面的代码只记录观察点，输出用于说明预期关系。

package cleanupdemo

import (
    "fmt"
    "testing"
)

func register(t *testing.T, label string) {
    // 把测试名称和资源标签绑定，避免多个子测试的日志混在一起。
    t.Cleanup(func() {
        t.Logf("cleanup %s: %s", t.Name(), label)
    })
}

func TestCleanupOrder(t *testing.T) {
    // 父级资源覆盖整个子测试组，所以在父级节点注册。
    register(t, "parent-resource")
    t.Cleanup(func() {
        // 这个回调与上一个回调属于同一个 *testing.T，后注册所以先执行。
        fmt.Println("parent-finalizer")
    })

    t.Run("database", func(t *testing.T) {
        // 子测试只负责自己的临时资源，名称会带上 database 层级。
        register(t, "child-resource")
        t.Cleanup(func() {
            // 子测试内部同样是后注册先执行。
            t.Log("child-finalizer")
        })
    })
}

在详细模式下，日志的文字顺序会受测试输出格式影响；稳定的判断依据是每条回调里的 t.Name()。预期观察关系可以概括为：子测试的两个清理回调先完成，随后父测试的两个清理回调按自己的注册逆序完成。父级第一个回调不会插入子测试内部。

父子测试如何定位清理回调属于谁

排查顺序错乱时，先不要靠日志出现的先后猜测。给每个回调同时记录 t.Name()、资源标签和注册位置，便能回答“哪个测试注册了它”。父测试名通常是 TestCleanupOrder，子测试名是 TestCleanupOrder/database。

如果测试还包含更深层的 t.Run，名称会继续用斜杠分层。这样做比只写“cleanup done”可靠，因为并行场景下不同子测试的输出可能交错，而名称仍然携带归属。

并行子测试和清理中的失败要怎么处理

共享资源的生命周期要放在父级：父测试注册客户端，子测试只使用它，父级清理等所有子测试结束后再释放。若子测试调用了 t.Parallel()，不要在父测试正文紧接着释放共享资源；应让父级的 Cleanup 承担组级回收。

还要留意两个坑。第一，Cleanup 回调里继续注册新的 Cleanup 是允许的，但会让清理栈更难读，最好只在封装测试基础设施时使用。第二，某个清理函数发生 panic 时，testing 仍会尝试执行剩余清理；因此清理动作应尽量幂等，并在回调中保留足够的名称信息。

实际检查可以按这三项完成：资源由哪一级创建；Cleanup 注册在哪个 *testing.T 上；回调日志是否包含完整测试名称。三项都对上后，再讨论是否需要调整注册顺序。

相关问题

Cleanup 和 defer 应该怎么选？

普通函数局部资源用 defer；测试资源需要覆盖当前测试及子测试时用 t.Cleanup。两者可以同时存在，但职责不要交叉。

父测试能观察子测试 Cleanup 完成吗？

可以在父级继续执行的位置观察子测试已经返回，但不要把父级正文和父级 Cleanup 混为一个时点；后者仍在整个父测试生命周期结束时才运行。

为什么日志看起来不是注册的逆序？

先确认日志来自哪个测试名称，再考虑并行输出和测试运行器的格式。后进先出只保证同一测试节点的 Cleanup 注册顺序，不保证多个并行节点的日志全局排序。