JUnit集成测试环境初始化问题：@BeforeAll/@BeforeEach无效如何处理？

1. 核对注解的包路径与JUnit版本匹配 #

• JUnit 5（Jupiter）对应的初始化注解是org.junit.jupiter.api.BeforeAll和org.junit.jupiter.api.BeforeEach
• JUnit 4对应的是org.junit.BeforeClass（等价JUnit5的@BeforeAll）和org.junit.Before（等价JUnit5的@BeforeEach）
  如果混用了不同版本的注解（比如用JUnit5测试框架却导入JUnit4的注解），初始化逻辑肯定不会执行。

2. 检查方法修饰符是否符合要求 #

• @BeforeAll（JUnit5）或@BeforeClass（JUnit4）修饰的方法必须是静态方法，且无返回值
• @BeforeEach（JUnit5）或@Before（JUnit4）修饰的方法必须是非静态实例方法，且无返回值
  比如给@BeforeAll标注了非静态方法，或者给@BeforeEach标注了静态方法，都会导致初始化失效。

3. 确认测试类的注解配置 #

• JUnit5默认测试实例生命周期为PER_METHOD，此时@BeforeAll必须是静态方法；如果想让@BeforeAll用非静态方法，需要给测试类添加@TestInstance(TestInstance.Lifecycle.PER_CLASS)注解
• JUnit4测试类无需额外类注解，但要确保测试方法使用的是对应版本的@Test注解

4. 排查继承或自定义扩展的干扰 #

• 如果测试类继承了父类，检查父类的初始化方法是否覆盖或干扰子类的setUp逻辑
• 确认没有自定义的测试运行器（JUnit4的@RunWith）或扩展（JUnit5的@ExtendWith）拦截了初始化流程

正确用法示例 #

JUnit5 示例 #

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

public class IntegrationTest {

    // 全局环境初始化，仅执行一次
    @BeforeAll
    static void setUpGlobalEnv() {
        // 执行启动服务、初始化数据库连接池等全局操作
    }

    // 单测数据初始化，每个测试方法执行前运行
    @BeforeEach
    void setUpTestData() {
        // 执行清空测试表、初始化测试对象等操作
    }

    @Test
    void testNewFeature1() {
        // 测试逻辑
    }

    @Test
    void testNewFeature2() {
        // 测试逻辑
    }
}

JUnit4 示例 #

import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Test;

public class IntegrationTest {

    @BeforeClass
    public static void setUpGlobalEnv() {
        // 全局环境初始化操作
    }

    @Before
    public void setUpTestData() {
        // 单测数据初始化操作
    }

    @Test
    public void testNewFeature1() {
        // 测试逻辑
    }
}

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