Maven单元测试失败但IDE独立运行正常，求助排查及依赖配置

一、@BeforeEach未执行的常见原因及修复 #

1. Surefire插件版本不兼容 #

Maven Surefire老版本不支持JUnit 5（Jupiter）和Java 16，必须升级到3.0.0-M5及以上版本，才能让JUnit 5的注解正常触发。

2. JUnit依赖配置不全 #

用JUnit 5的话，必须同时引入API和引擎两个依赖：

• junit-jupiter-api是编写测试的核心API，scope设为test
• junit-jupiter-engine是运行测试的核心引擎，缺了它测试根本无法正常启动，@BeforeEach自然不会执行

3. 测试类注解/导入出错 #

• 不要添加JUnit4的@RunWith注解，JUnit 5不需要这个老特性，加了会直接导致@BeforeEach失效
• 确认@BeforeEach的导入路径是org.junit.jupiter.api.BeforeEach，而非JUnit4的org.junit.Before（后者在JUnit5环境下完全不生效）

4. 测试类命名不符合Surefire扫描规则 #

Surefire默认只扫描以下命名规则的测试类：

• **/Test*.java
• **/*Test.java
• **/*Tests.java
• **/*TestCase.java
  如果你的测试类名不符合上述规则，需要在Surefire插件中配置includes参数指定测试类路径。

二、适配Java 16的JUnit 5规范Maven配置 #

以下是标准配置，直接复制到你的pom.xml即可使用：

1. 基础属性配置 #

<properties>
    <maven.compiler.source>16</maven.compiler.source>
    <maven.compiler.target>16</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <!-- 统一管理依赖版本 -->
    <junit-jupiter.version>5.9.2</junit-jupiter.version>
    <maven-surefire-plugin.version>3.1.2</maven-surefire-plugin.version>
</properties>

2. JUnit 5依赖配置 #

<dependencies>
    <!-- JUnit Jupiter 核心API -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>${junit-jupiter.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit Jupiter 测试引擎 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>${junit-jupiter.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- 可选：需要参数化测试时添加 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-params</artifactId>
        <version>${junit-jupiter.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

3. Surefire插件配置 #

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>${maven-surefire-plugin.version}</version>
            <!-- 强制指定使用JUnit Jupiter引擎 -->
            <dependencies>
                <dependency>
                    <groupId>org.junit.jupiter</groupId>
                    <artifactId>junit-jupiter-engine</artifactId>
                    <version>${junit-jupiter.version}</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

三、额外排查技巧 #

1. 执行mvn clean test -X查看详细日志，确认Surefire是否加载了JUnit Jupiter引擎，以及你的测试类是否被正确扫描
2. 如果是Spring项目，确保测试类添加了@SpringBootTest（JUnit5下该注解已包含必要的扩展支持），避免因上下文未初始化导致变量空指针
3. 检查测试类中mySet的初始化代码，确认@BeforeEach方法里确实完成了赋值操作

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