4. 测试实例生命周期控制：每方法新实例原理、实例变量隔离、影响分析

在 JUnit 5 中，测试类的实例创建策略默认采用 每方法新实例（PER_METHOD），这意味着每一个测试方法执行前都会生成一个全新的测试类实例。这一设计与 JUnit 4 中同一测试类共享一个实例的行为截然不同。本章深入剖析该原理、实例变量隔离机制以及对测试编写、性能与调试带来的影响。

4.1 原理：每方法新实例

JUnit 5 通过 TestInstanceFactory 和 TestInstanceLifecycle 接口控制实例创建。在 PER_METHOD 模式下，执行引擎在调用每个测试方法前都会：

1. 使用无参构造函数反射创建一个新对象；
2. 执行 @BeforeEach 方法（若有）；
3. 执行当前测试方法；
4. 执行 @AfterEach 方法；
5. 丢弃该实例（等待 GC）。

该模式保证了测试方法之间的 完全隔离，但每次创建实例会带来额外的构造开销和资源分配。相反，PER_CLASS 模式（通过 @TestInstance(Lifecycle.PER_CLASS) 显式开启）则复用同一个实例，允许 @BeforeAll 和 @AfterAll 在非静态方法中使用。

4.2 实例变量隔离机制

在 PER_METHOD 下，所有非静态字段（实例变量）在每个测试方法执行前都会被重新初始化。由于测试类实例彼此独立，某个方法对实例变量的修改不会影响到其他方法。例如：

public class CounterTest {
    private int count = 0;

    @Test
    void first() {
        count = 1;
        // 此实例的 count = 1
    }

    @Test
    void second() {
        // 新实例，count = 0（不受 first 影响）
        assertEquals(0, count);
    }
}

这种隔离机制消除了测试间的偶发依赖，使得测试可以任意排序、并行执行而无需担心副作用。但同时也意味着 不能利用实例变量在测试方法间共享预先计算的数据，必须依靠 @BeforeAll 静态方法或外部资源。

4.3 影响分析

• 测试顺序独立性： 每个方法从零开始，测试执行顺序不影响结果，可安全使用 @TestMethodOrder 或并行执行。
• 共享资源管理： 数据库连接、文件句柄等重量级资源无法通过实例变量在方法间复用，通常需要 @BeforeAll 静态方式或使用 TestInstanceFactory 自定义实例池。
• 性能开销： 每方法新实例会频繁触发构造函数、依赖注入以及 @BeforeEach 中的准备逻辑。如果测试类包含大量 @BeforeEach 操作或复杂依赖，总执行时间会显著增加。
• 并行测试安全： 实例变量在多线程下天然安全（每个线程拥有自己的实例），但静态字段仍存在竞态条件，需注意同步。
• 调试友好性： 每个测试方法的独立堆栈更易定位失败原因，因为不需要考虑之前方法留下的状态。

下表以典型场景对比两种生命周期在资源消耗上的差异：

4.4 实例生命周期对比流程图

下图展示了 PER_METHOD 与 PER_CLASS 模式下实例创建与测试方法执行的流程差异：

4.5 常见错误与调试

• 实例变量“残留”幻觉： 在 PER_METHOD 下，认为一个方法中设置的实例变量能在后续方法中读到，导致断言失败。应始终从零开始假设。
• 静态 @BeforeAll 误用： 有些开发者习惯将 @BeforeAll 声明为静态，但在 PER_CLASS 下并非必须。切换生命周期后忘记修改修饰符会引发编译错误。
• 性能误判： 将重量级初始化放在 @BeforeEach 中，导致每方法都重复执行，整体测试变慢。可通过 @TestInstance(Lifecycle.PER_CLASS) 重构或使用静态初始化块。

调试时，可在测试类的构造函数或 @BeforeEach 中添加临时打印，确认实例的 hashCode() 是否随方法变化。例如：

public class DebugInstanceTest {
    public DebugInstanceTest() {
        System.out.println("New instance: " + this.hashCode());
    }
    @Test void t1() { System.out.println("t1 on " + this.hashCode()); }
    @Test void t2() { System.out.println("t2 on " + this.hashCode()); }
}

若输出显示不同 hash 值，则验证了每方法新实例模式生效。

4.6 性能与稳定性优化

• 轻量构造优先： 尽量避免在构造函数中执行耗时操作（如数据库连接、文件读取）。可将这些操作移至 @BeforeAll 静态方法或外部资源准备阶段。
• 选择合适生命周期： 如果测试类包含的测试方法数量较多（如 50+），且每个方法所需的初始化一致且无状态污染，考虑切换到 PER_CLASS。但必须同步静态资源或使用 ThreadLocal 保证线程安全。
• 避免实例变量 static 陷阱： 如果强制使用静态变量在 PER_METHOD 下共享状态，务必在 @AfterEach 或 @AfterAll 中清理，否则会影响后续测试。