一、mvn test 和 mvn surefire:test 的区别 #

很多刚接触Maven的同学都会疑惑这两个命令的差异，核心区别其实是生命周期阶段执行 vs 直接调用插件目标：

• mvn test 是Maven生命周期的一个阶段：它会按顺序执行test阶段之前的所有前置步骤，比如compile（编译主代码）、test-compile（编译测试代码），确保所有必要的class文件都准备就绪后，才触发绑定在test阶段的surefire:test目标执行测试。简单说，这是一套完整的“一条龙”流程，适合从头构建测试的场景。
• mvn surefire:test 是直接调用Surefire插件的test目标：它不会触发任何Maven生命周期的前置阶段，只会单纯执行测试任务。如果你的代码还没编译，或者测试类的class文件不存在，直接跑这个命令大概率会报错，或者找不到可执行的测试。它更适合已经完成编译，只想快速重新执行测试的场景。

总结一下：mvn test稳妥全面，surefire:test快捷但依赖前置条件，按需选择就行。

二、为什么你的JUnit 5测试始终显示Tests run: 0？ #

从你描述的情况看，项目结构没问题，测试类也编译到了target/test-classes，问题出在JUnit 5的依赖配置和Surefire插件的支持上，具体分析和解决步骤如下：

1. 核心依赖缺失：JUnit 5需要API+引擎双搭配 #

你只添加了junit-jupiter-api（这是JUnit 5的注解和API定义），但缺少junit-jupiter-engine——这才是真正执行JUnit 5测试的核心引擎。没有引擎，Surefire插件找不到可执行的测试框架，自然会显示测试数为0。

2. Surefire插件版本过低，不兼容JUnit 5 #

Maven默认的Surefire插件版本通常比较老，很多旧版本不支持JUnit 5。你需要明确指定一个支持JUnit 5的Surefire版本（3.0.0-M5及以上版本都支持），并配置它使用JUnit 5引擎。

3. 依赖冲突：JUnit 4和JUnit 5共存可能干扰测试执行 #

你的pom里同时引入了JUnit 4.12和JUnit 5的依赖，虽然理论上可以兼容，但可能会让Surefire插件混淆该用哪个引擎执行测试。如果你的测试代码全用JUnit 5注解，建议移除JUnit 4的依赖。

调整后的配置示例 #

更新你的pom.xml，修正依赖和插件配置：

<!-- 移除JUnit 4依赖（如果不需要的话） -->
<!-- <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope>
</dependency> -->

<!-- JUnit 5 必要依赖 -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.0.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.0.2</version>
    <scope>test</scope>
</dependency>

<!-- 配置Maven Compiler插件，确保Java版本≥8（JUnit 5要求） -->
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.7.0</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
        <!-- 配置Surefire插件支持JUnit 5 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M7</version>
            <configuration>
                <includes>
                    <include>**/*Test.java</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

最后验证步骤 #

执行mvn clean test——先清理之前的target目录，避免缓存的旧文件干扰，然后重新编译并执行测试。这样应该就能正常识别并运行你的JUnit 5测试了。

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