Apache Maven 3.5.2中Surefire插件未执行单元测试问题

我来帮你排查这个问题——你遇到的情况在使用Maven旧版本Surefire插件时很常见，虽然mvn test显示构建成功，但没有任何测试执行痕迹，核心原因大概率是测试类没被Surefire插件识别到，结合你用的2.18.1版本特性，咱们一步步解决：

1. 先检查测试类的命名规则 #

Surefire 2.18.1的默认扫描规则非常严格，只会自动执行符合以下格式的测试类：

• **/Test*.java（比如TestUserService.java）
• **/*Test.java（比如UserServiceTest.java）
• **/*TestCase.java（比如UserServiceTestCase.java）

如果你的测试类是UserServiceTests.java、TestUser.java这类不符合上述规则的命名，Surefire会直接忽略它们。

2. 确认测试类的存放路径 #

Maven有明确的约定：测试类必须放在src/test/java目录下，且包结构要和主代码保持一致。如果你的测试类误放在src/main/java或其他自定义目录，Surefire不会主动扫描这些位置。

3. 显式声明Surefire插件并调整配置 #

如果上面两点都没问题，建议你直接在pom.xml里显式声明Surefire插件——一方面可以升级到更灵活的新版本，另一方面能自定义扫描规则，确保测试类被识别：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <!-- 推荐升级到稳定的新版本，比如3.2.5 -->
            <version>3.2.5</version>
            <configuration>
                <!-- 自定义扫描规则，适配你的测试类命名 -->
                <includes>
                    <include>**/*Tests.java</include>
                    <include>**/Test*.java</include>
                    <include>**/*Test.java</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

4. 验证有效pom的配置 #

你可以执行mvn help:effective-pom命令，仔细查看Surefire插件的完整配置，排查是否有父pom或其他依赖的配置覆盖了默认规则——比如有没有设置<excludes>标签把你的测试类排除在外。

做完这些步骤后，重新执行mvn test，应该就能看到测试用例的执行日志了。

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