当前位置：首页 > 文章列表 > Golang > Go教程 > Go testing.T.Cleanup 注册多个清理函数时顺序是什么

Go testing.T.Cleanup 注册多个清理函数时顺序是什么

来源：17golang原创 2026-09-10 11:58:11 0浏览收藏

Go 的 testing.T.Cleanup 不是“注册几个就按几个的顺序执行”。同一个测试对象上，清理函数遵循后注册先调用的 LIFO 规则；而且它会等当前测试及其子测试完成后才进入清理阶段。要安排有依赖的资源释放，先把依赖关系画出来，再决定注册顺序。

要点速览

后调用 t.Cleanup 注册的回调先执行，先注册的最后执行。
子测试自己的清理属于子测试边界；父测试的清理要等所有子测试结束。
并发调用 Cleanup 时不要依赖注册先后，资源依赖应改成显式、可复查的安排。

多个 t.Cleanup 为什么是后注册先执行

官方 testing 文档把规则写得很明确：Cleanup 注册的函数会在测试以及它的子测试完成后调用，并按“最后添加、最先调用”的顺序执行。可以把同一个 T 上的回调理解成一摞清理卡片：后放上去的卡片先取走。

因此，若上层资源依赖底层资源，通常先注册上层资源的释放，再注册底层资源的释放。这样后注册的底层释放会先执行，反而可能不符合依赖；更稳妥的做法是让“需要先释放”的回调最后注册，并在代码中用注释写清原因。

注册关系	调用关系	适合放什么
先注册	后调用	依赖层较底、需要更晚释放的资源
后注册	先调用	依赖层较上、需要先释放的资源

Go testing.T.Cleanup 后注册先调用的清理回调栈、测试生命周期和资源句柄关系图 — 图1：用测试生命周期边界和清理回调栈理解 testing.T.Cleanup 的后注册先执行规则。

下面这个例子把两个回调挂在子测试上，再由父测试读取记录。代码中的注释专门标出注册顺序，避免把它和 defer 的阅读习惯混在一起。

package cleanup_test

import (
    "reflect"
    "testing"
)

func TestCleanupOrder(t *testing.T) {
    var events []string

    t.Run("case", func(t *testing.T) {
        t.Cleanup(func() {
            // 先注册的回调最后执行，适合较晚释放底层依赖。
            events = append(events, "first")
        })
        t.Cleanup(func() {
            // 后注册的回调先执行，适合先释放上层资源。
            events = append(events, "second")
        })
    })

    // 子测试返回后，它的两个 Cleanup 已完成，父测试可以读取完整记录。
    want := []string{"second", "first"}
    if !reflect.DeepEqual(events, want) {
        t.Fatalf("cleanup order = %v, want %v", events, want)
    }
}

这里的断言放在 t.Run 返回之后，是因为子测试的清理阶段属于子测试生命周期。若在子测试内部就读取 events，你看到的仍可能是不完整状态。