登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go testing.T.Parallel 为什么会改变测试夹具生命周期

来源:17golang原创

时间:2026-11-19 06:40:43 291浏览 收藏

调用 t.Parallel() 会让子测试暂停,等待父测试函数返回后再参与并行调度。因此,父函数中的 defer 可能先关闭共享连接或删除文件,子测试恢复时夹具已经失效。把共享夹具的释放注册到父测试的 t.Cleanup,才能让清理范围覆盖其全部子测试。

把夹具归属于整棵测试子树

这里适合采用“测试子树拥有资源”的设计:父测试负责创建和登记释放,子测试只是借用者。测试夹具指准备好的输入文件、服务或其他测试依赖。函数作用域与测试树的完成范围不是同一个概念;局部变量仍被闭包引用,也不代表变量指向的外部资源仍然有效。

父测试与并行子测试共享只读夹具的所属关系
静态结构说明图:父测试拥有夹具和清理登记,两个子测试借用同一文件;连线表示所属与引用关系。

什么时候需要共享夹具

例如多个解析场景要读取一份体积较大的只读字典,可以让父测试准备一次。如果场景会覆盖文件、修改数据库行或调整服务配置,共享会增加相互干扰;这时先选择每个子测试独立创建夹具。并行执行只提供调度能力,不会自动为可变数据建立锁或快照。

用父测试 Cleanup 管理只读文件

下面是一个独立的测试文件示例。父测试通过 TempDir 管理目录,并额外注册文件清理来展示责任归属。目录自动清理已经足以覆盖文件,实际项目可省略这段额外删除;对连接、服务器等资源则注册相应关闭函数。示例用于说明写法,未在本文环境执行。

package fixture

import (
    "os"
    "path/filepath"
    "testing"
)

func TestSharedDictionary(t *testing.T) {
    // 临时目录归父测试所有,其清理覆盖所有子测试。
    root := t.TempDir()
    path := filepath.Join(root, "dictionary.txt")
    if err := os.WriteFile(path, []byte("cedar=杉木"), 0600); err != nil {
        t.Fatal(err)
    }
    // 演示显式资源清理;目录本身仍由 TempDir 自动移除。
    t.Cleanup(func() {
        if err := os.Remove(path); err != nil && !os.IsNotExist(err) {
            t.Errorf("删除共享字典失败: %v", err)
        }
    })

    for _, name := range []string{"lookup", "export"} {
        t.Run(name, func(t *testing.T) {
            t.Parallel()
            // 两个消费者只读同一份内容,不修改共享文件。
            data, err := os.ReadFile(path)
            if err != nil {
                t.Fatal(err)
            }
            if string(data) != "cedar=杉木" {
                t.Errorf("字典内容不符: %q", data)
            }
        })
    }
}

清理函数登记在父级 t 上,不能误放到第一个使用者的子级 t 上,否则它只能覆盖那个子测试及其后代。这里的两个子测试只读文件;如果改成写入,应分配独立路径或明确同步规则。

父函数 defer 为什么会提前删除文件

下面的反例与上例使用相同导入。父测试函数退出会执行 defer 中的文件删除,而 reader 在调用 Parallel 后暂停;所以 defer 不适合承担这份共享文件的释放责任。仅把删除函数封装成 helper,不会改变其执行范围。

func TestEarlyCleanup(t *testing.T) {
    root := t.TempDir()
    path := filepath.Join(root, "seed.txt")
    if err := os.WriteFile(path, []byte("seed"), 0600); err != nil {
        t.Fatal(err)
    }
    // 反例:函数返回时删除,不能覆盖尚未恢复的并行子测试。
    defer func() {
        if err := os.Remove(path); err != nil {
            t.Errorf("删除夹具失败: %v", err)
        }
    }()
    t.Run("reader", func(t *testing.T) {
        t.Parallel()
        if _, err := os.ReadFile(path); err != nil {
            t.Fatal(err)
        }
    })
}

一个替代办法是把并行子测试放进不调用 Parallel 的中间分组:外层等待该分组的 Run 返回,再释放资源。这适用于需要在同一外层函数中继续处理其他工作的情况;简单的父级资源所有权通常用 Cleanup 更直观。

把清理责任与数据隔离一起设计

登记清理只是解决资源活得够久。还要保证共享内容不会被一个消费者破坏。将共享输入视为只读,将每例输出放入子测试自己的临时目录,能把“共享准备成本”与“独立结果”分开。

共享输入与两个子测试私有输出目录的边界
静态结构说明图:字典是共同输入,输出目录分别归各自子测试所有;这张图不表示执行顺序。
资源所属测试使用约束
共享输入字典父测试所有消费者只读
每例输出目录对应子测试互不复用路径
关闭与删除登记资源所有者不交给任意借用者

选择写法的清单与相关问题

改造既有测试时,先列出资源的创建者、全部使用者和释放位置;确认父级返回后是否还有暂停的子测试;再决定共享只读输入还是每例独立副本。不要靠延迟几毫秒来碰运气,也不要让父测试等待一个只能在它返回后才恢复的子测试发信号。

子测试里创建的夹具可以用 defer 吗?

如果仅在该函数返回前使用,defer 可以正常释放;若其后代也调用 Parallel 并继续使用,则仍应让清理覆盖相应测试子树。

加 Cleanup 就能让共享 map 并发写安全吗?

不能。资源存活与并发数据访问是两个问题。需要选择独立 map 或恰当的同步方式。

所有子测试都会立刻同时运行吗?

不会。Parallel 表示测试可参加并行调度,并非承诺立刻执行或与所有兄弟同时运行。

参考:testing.Cleanup 文档、Go 官方子测试说明。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>