Spring项目Maven test命令无法执行测试的排查与解决

我来帮你搞定这个问题——你遇到的情况是IDEA能正常运行测试，但Maven的test命令却显示执行了0个测试，核心原因和解决办法如下：

主要原因 #

问题的核心在于你用的Maven Surefire插件2.22.1版本默认不会自动适配JUnit 5（Jupiter）的测试类。虽然你的测试类命名SomethingTest.java符合Surefire的默认识别规则（以Test结尾），但因为插件和JUnit 5的适配配置缺失，导致它找不到带有JUnit 5注解的测试方法。

另外还要注意：如果你的测试类目录结构和包名不匹配（比如把包名的点当成了目录分隔符，实际目录应该是com/mypackage/sth/utils而不是com.mypackage.sth/utils），也可能导致测试类没被编译到target/test-classes目录，不过从你的日志看testCompile步骤显示“all classes are up to date”，大概率是适配问题。

解决方法 #

1. 给Surefire插件添加JUnit Jupiter Provider依赖 #

在pom.xml的maven-surefire-plugin配置里，明确添加JUnit 5的provider依赖，让插件能识别JUnit Jupiter的测试注解。配置代码如下：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.1</version>
            <dependencies>
                <dependency>
                    <groupId>org.junit.platform</groupId>
                    <artifactId>junit-platform-surefire-provider</artifactId>
                    <version>1.4.2</version>
                </dependency>
            </dependencies>
        </plugin>
        <!-- 保留你原有的spring-boot-maven-plugin配置 -->
    </plugins>
</build>

2. 确认测试类使用正确的注解 #

确保你的测试类用的是JUnit 5的@Test注解（包路径是org.junit.jupiter.api.Test），而不是JUnit 4的org.junit.Test。混用旧注解也会导致Surefire无法识别测试方法。

3. 验证测试类的编译结果 #

执行mvn clean test-compile命令，然后查看项目根目录下的target/test-classes文件夹，确认里面存在com/mypackage/sth/utils/SomethingTest.class文件。如果不存在，说明你的测试类目录结构和包名不匹配，需要调整目录为src/test/java/com/mypackage/sth/utils/（用斜杠分隔目录，不是点）。

4. 升级Surefire插件版本（推荐） #

如果你不想手动配置provider，可以把maven-surefire-plugin升级到3.0.0-M1及以上版本，这些版本默认支持JUnit 5，不需要额外添加依赖。示例配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.1.2</version>
</plugin>

配置完成后，执行mvn clean test，应该就能看到测试类被正常执行了。

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