JUnit测试生命周期夹具设计从入门到精通 - 第1节

1.1 理解测试生命周期与夹具

测试生命周期（Test Lifecycle）定义了从测试实例创建到销毁的完整过程。夹具（Fixture）是测试执行前后固定环境状态的机制，包括数据准备、资源初始化、清理与释放。JUnit 通过注解驱动的方式将这些生命阶段暴露给开发者，使得每个测试方法在隔离且可复现的环境中运行。

1.1.1 核心概念解释

概念 定义 与夹具的关系
测试生命周期 测试实例创建、方法执行、实例销毁的先后顺序 夹具方法绑定在生命周期的特定节点上
夹具（Fixture） 一组预先设置到已知状态的代码和数据 通过 @BeforeEach、@AfterEach 等注解声明
共享夹/具 跨所有测试方法只初始化一次的全局状态 使用 @BeforeAll、@AfterAll 静态方法
隔离性 每个测试方法不依赖其他测试的执行结果 夹具在每次方法前后重新建立干净状态

1.1.2 标准生命周期流程

JUnit 5（Jupiter）为每个测试类遵循固定的执行顺序：

  1. 类级别初始化：执行 @BeforeAll 标注的静态方法（仅一次）。
  2. 实例化：为每个测试方法创建新的测试类实例。
  3. 实例级别准备：执行 @BeforeEach 标注的方法。
  4. 测试方法执行：运行 @Test 标注的方法体。
  5. 实例级别清理：执行 @AfterEach 标注的方法。
  6. 类级别销毁：所有测试方法完成后，执行 @AfterAll 静态方法（仅一次）。
注意：第 2~5 步会为每个 @Test 方法重复执行，确保方法间状态隔离。第 1 和第 6 步只执行一次，适合重量级资源（如数据库连接池、容器）。

1.2 核心注解介绍

JUnit 5 提供以下生命周期注解，通过它们可以精确控制夹具的安装与拆除时机。

注解 修饰目标 执行次数 典型用途
@BeforeAll 静态方法 整个类执行一次（最先） 打开全局连接、加载配置文件
@AfterAll 静态方法 整个类执行一次（最后） 关闭全局连接、释放共享资源
@BeforeEach 实例方法 每个测试方法前执行 创建测试数据、重置 mock 对象
@AfterEach 实例方法 每个测试方法后执行 清理临时表、删除缓存文件

1.2.1 注解使用示例

下面是一个完整的夹具代码示例：

import org.junit.jupiter.api.*;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

class FileBackedStorageTest {

    private Path tempFile;

    @BeforeAll
    static void initGlobal() {
        System.out.println("[BeforeAll] 仅执行一次：加载配置");
    }

    @BeforeEach
    void createTempFile() throws IOException {
        tempFile = Files.createTempFile("test-", ".tmp");
        System.out.println("[BeforeEach] 创建临时文件: " + tempFile);
    }

    @Test
    void testWrite() throws IOException {
        Files.writeString(tempFile, "hello");
        String content = Files.readString(tempFile);
        Assertions.assertEquals("hello", content);
    }

    @Test
    void testEmptyByDefault() throws IOException {
        String content = Files.readString(tempFile);
        Assertions.assertTrue(content.isEmpty());
    }

    @AfterEach
    void deleteTempFile() throws IOException {
        Files.deleteIfExists(tempFile);
        System.out.println("[AfterEach] 删除临时文件: " + tempFile);
    }

    @AfterAll
    static void cleanupGlobal() {
        System.out.println("[AfterAll] 仅执行一次：释放全局资源");
    }
}

1.3 基于生命周期的夹具工作流

下图展示了两个测试方法的完整生命周期与夹具方法调用序列：

JUnit 5 测试生命周期及夹具调用流程 @BeforeAll 仅一次：初始化共享资源 实例 1 @BeforeEach 创建tempFile @Test testWrite() @AfterEach 删除tempFile 实例 2 @BeforeEach 创建tempFile @Test testEmptyByDefault() @AfterEach 删除tempFile @AfterAll 仅一次：释放全局资源 关键隔离保证 • 每次测试前执行 @BeforeEach • 每次测试后执行 @AfterEach • 实例变量在方法间不共享 • @BeforeAll/@AfterAll 仅一次

1.4 常见错误与调试提示

1.4.1 误用静态方法

@BeforeAll 和 @AfterAll 必须标注在 静态方法 上。如果错误地标注在实例方法上，JUnit 会在运行时抛出异常：

org.junit.platform.commons.JUnitException: @BeforeAll method 'public void a()' must be static.

1.4.2 夹具顺序依赖

不要编写依赖于 @BeforeEach 中子方法执行顺序的代码。如果需要严格顺序，应抽取为单一方法。否则，子类继承时可能产生不可预测的执行链。

1.4.3 实例变量污染

即使使用 @BeforeEach 重置，如果在 @Test 中修改了引用型变量（如 List、Map），而 @AfterEach 未完全清理，后续方法仍可能读取到修改后的对象。建议在 @BeforeEach 中重新创建所有可变对象。

1.4.4 调试日志输出技巧

在开发阶段，可以在夹具方法中用 System.out 或日志框架输出跟踪信息：

@BeforeEach
void setUp(TestInfo testInfo) {
    System.out.println("准备执行测试: " + testInfo.getDisplayName());
}

JUnit 5 自动将 TestInfo 注入到任意生命周期方法中，无需手动创建。

建议：在 @BeforeEach 中使用 TestInfo 获取当前测试方法名，方便调试时区分不同测试的夹具行为。

1.5 生命周期定制的扩展接口

除了注解，JUnit 5 还提供 BeforeAllCallback、BeforeEachCallback 等扩展接口，可供全局或按类注册的自定义扩展使用。该内容将在第 7 章详细展开，此处仅作概念介绍。

核心接口签名：

import org.junit.jupiter.api.extension.*;

public class MyExtension implements BeforeEachCallback {
    @Override
    public void beforeEach(ExtensionContext context) throws Exception {
        // 在每个测试方法前执行逻辑
        System.out.println("扩展 BeforeEach: " + context.getDisplayName());
    }
}
← 上一章 📖 返回目录 下一章 →