JUnit 4与JUnit 5执行顺序差异：@BeforeAll重复执行问题

这是个很常见的JUnit版本迁移问题，我来帮你理清背后的原因，再给你几个实用的解决思路～

为什么会出现这个差异？ #

JUnit 4和JUnit 5（Jupiter）的测试生命周期设计有本质区别：

• 在JUnit 4中，@BeforeClass（对应JUnit5的@BeforeAll）是静态方法，父类的静态初始化逻辑只会在类第一次被加载时执行一次。当你批量执行所有包的测试时，所有子类共享父类的静态状态，所以整个测试运行中@BeforeClass只会触发一次。
• 而JUnit 5的Jupiter引擎把每个测试类（包括继承自BaseTest的子类）都当作独立的测试容器。即使子类继承了同一个父类，每个子类的@BeforeAll（静态方法）都会被单独触发——因为每个子类都是独立的类实例上下文，所以跨包执行时，切换到新包的测试类就会重新执行父类的@BeforeAll。

解决办法 #

根据你的需求，有几种可行的方案：

方案1：用测试套件统一管理全局初始化 #

把原来BaseTest中的一次性初始化逻辑移到测试套件类的@BeforeAll中，这样整个测试套件执行时只会初始化一次：

import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.Suite;
import org.junit.jupiter.api.BeforeAll;

@Suite
@SelectPackages({"package.a", "package.b"}) // 指定要执行的所有包
public class AllTestsSuite {

    @BeforeAll
    static void globalSetup() {
        // 这里放原来BaseTest中@BeforeAll的初始化逻辑
    }
}

之后你只需要运行这个套件类，就能触发全局只执行一次的初始化，同时保留BaseTest中@BeforeEach和@AfterEach的测试前后逻辑。记得把BaseTest里的@BeforeAll删掉哦。

方案2：用静态单例类确保初始化只执行一次 #

如果不想改测试结构，可以把初始化逻辑封装到一个静态单例类中，通过判断标记避免重复执行：

// 全局初始化工具类
public class GlobalInitializer {
    private static boolean isInitialized = false;

    public static void init() {
        if (!isInitialized) {
            // 执行你的一次性初始化逻辑
            isInitialized = true;
        }
    }
}

然后修改BaseTest的@BeforeAll方法：

public class BaseTest {

    @BeforeAll
    static void setup() {
        GlobalInitializer.init(); // 调用单例初始化方法
    }

    // 保留@BeforeEach和@AfterEach的逻辑
    @BeforeEach
    void prepareTestData() { /* ... */ }

    @AfterEach
    void cleanTestData() { /* ... */ }
}

这样不管有多少个子类执行，GlobalInitializer.init()只会在第一次被调用时执行初始化。

方案3：用JUnit 5扩展实现全局初始化 #

自定义一个JUnit扩展，实现BeforeAllCallback接口，通过静态标记确保只执行一次：

import org.junit.jupiter.api.extension.BeforeAllCallback;
import org.junit.jupiter.api.extension.ExtensionContext;

public class GlobalSetupExtension implements BeforeAllCallback {
    private static boolean initialized = false;

    @Override
    public void beforeAll(ExtensionContext context) throws Exception {
        if (!initialized) {
            // 执行全局初始化逻辑
            initialized = true;
        }
    }
}

然后在BaseTest上添加扩展注解：

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

@ExtendWith(GlobalSetupExtension.class)
public class BaseTest {
    // 保留@BeforeEach和@AfterEach逻辑，移除原来的@BeforeAll
}

这个扩展会在所有测试类执行前触发，但因为有静态标记，只会执行一次初始化。

内容的提问来源于stack exchange，提问作者Homewrecker