📚 课程目录第3章 @BeforeAll与@AfterAll静态生命周期

@BeforeAll 与 @AfterAll 静态生命周期：类级别资源管理、执行限制、静态字段使用

1. 原理：类级别夹具的定位

在 JUnit 5 中，@BeforeAll 和 @AfterAll 是作用于整个测试类的生命周期方法。它们在所有测试方法之前/之后执行一次，且必须声明为 static（除非使用 @TestInstance(Lifecycle.PER_CLASS)）。其核心价值在于管理类级别的资源——例如数据库连接池、文件锁、外部服务客户端或内存缓存——这些资源不需要在每个测试方法后重建，也不应被不同测试实例重复初始化。

执行顺序：

测试类加载 → @BeforeAll 静态方法 → 实例化（如有多个测试） → @BeforeEach → 测试方法 → @AfterEach → @AfterAll 静态方法

2. 实现流程与代码模板

标准使用模式如下：

在类中声明 private static 资源字段；
@BeforeAll static void setUpClass() 中初始化该资源；
@AfterAll static void tearDownClass() 中清理该资源。

import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;

public class DatabaseTest {

    private static DatabaseConnection conn;

    @BeforeAll
    static void openDatabase() {
        conn = new DatabaseConnection("jdbc:h2:mem:test");
        conn.open();
        System.out.println("🔵 @BeforeAll: 连接已建立");
    }

    @AfterAll
    static void closeDatabase() {
        conn.close();
        System.out.println("🔴 @AfterAll: 连接已关闭");
    }

    @Test
    void shouldInsertRecord() {
        conn.execute("INSERT INTO users VALUES (1, 'Alice')");
        assertTrue(conn.query("SELECT * FROM users").size() > 0);
    }

    @Test
    void shouldQueryEmpty() {
        int count = conn.execute("SELECT COUNT(*) FROM users");
        assertEquals(0, count, "每次测试后数据应被回滚或清理");
    }
}

3. 执行限制与静态字段使用规则

限制点	说明	解决方案
修饰符要求	方法必须为 `static`（默认 `PER_METHOD` 生命周期下）	显式标注 `@TestInstance(Lifecycle.PER_CLASS)` 后可改为实例方法
异常处理	静态方法不可直接访问非静态字段	资源字段声明为 `private static`
继承影响	子类的 `@BeforeAll` 会覆盖父类同名方法	使用 `super` 调用或调整继承结构
线程安全	若测试并行执行，静态字段存在竞态	使用 `synchronized` 或线程安全容器

4. API 签名与参数

@BeforeAll 和 @AfterAll 可接受一个 TestInfo 或 RepetitionInfo 参数，提供测试元数据。

@BeforeAll
static void initTestEnvironment(TestInfo testInfo) {
    System.out.println("测试类: " + testInfo.getTestClass().get().getSimpleName());
}

5. 调试：验证静态方法调用次数

在复杂测试套件中，可在 @BeforeAll 中嵌入计数器，确认方法只执行一次：

private static int setupCallCount = 0;

@BeforeAll
static void countSetup() {
    setupCallCount++;
}

@Test
void checkSingleSetup() {
    assertEquals(1, setupCallCount);
}

若失败，检查是否有多个测试运行器同时加载该类，或 @TestInstance(PER_CLASS) 已改变执行模型。

6. 部署注意事项

资源泄露：@AfterAll 必须放置在 final 位置，无论测试成功或失败都应执行；JUnit 保证即使测试抛出异常，@AfterAll 仍然运行。
连接池复用：静态字段中存储的数据库连接、HTTP 客户端等应设置为 idle 超时，避免长期占用。
环境隔离：类级别资源不应在测试间共享可变状态，除非显式重置（如每次测试后清空表数据）。

7. 常见错误与模式

典型错误	后果	正确做法
忘记声明 `static`	`BeforeAll` 方法不会被识别，抛出异常	添加 `static` 或使用 `@TestInstance(PER_CLASS)`
静态字段被多次覆盖	子类破坏父类资源状态	唯一资源命名或使用组合模式
在 `@BeforeAll` 中调用 `fail()`	整类测试全跳过	将依赖检查移至 `@BeforeEach` 或使用 `Assumptions`
静态资源未释放	测试后端口占用/文件锁残留	在 `@AfterAll` 中调用 `close()` 或 `cleanup()`

💡 技巧：若使用 @TestInstance(PER_CLASS)，@BeforeAll 可变为非静态方法，需配合 @AfterAll 非静态清理，但此时实例在类间复用，需注意字段状态残留。

8. 性能与稳定性优化

懒加载：在 @BeforeAll 中应使用轻量初始化，若资源昂贵（如启动容器），可考虑延迟到第一个测试触发。
清理顺序：若多个静态资源存在依赖，在 @AfterAll 中按依赖逆序关闭，防止死锁。
并行限制：使用 @Execution(ExecutionMode.CONCURRENT) 时，静态字段必须加锁或改为 ThreadLocal。

// 线程安全的静态计数器
private static final AtomicReference<HttpClient> clientRef = new AtomicReference<>();

@BeforeAll
static void initHttp() {
    clientRef.updateAndGet(old -> old != null ? old : HttpClient.newHttpClient());
}

9. 生命周期流程图

下图展示了 @BeforeAll / @AfterAll 在类级别资源管理中的位置与交互：

10. 小结

@BeforeAll 和 @AfterAll 是 JUnit 5 中最强大的类级别夹具工具。通过静态字段持有昂贵资源，并在测试前后统一管理，可以显著提升测试套件的执行效率与可维护性。使用时需严格遵循静态方法的限制，并考虑并发场景下的线程安全。掌握这一模式，是构建企业级测试底座的第一步。