Maven 3.8.6 运行 JUnit 5 测试方法

本文直击 Maven 3.8.6 中运行 JUnit 5 测试失败的痛点——不是代码有问题，而是构建链路的版本兼容性陷阱：旧版 surefire 插件（如 2.22.0）无法正确识别 JUnit 5 的 @Test 方法，加上 Maven 3.8+ 对仓库和元数据的严格校验，导致测试静默跳过或无响应；文章不仅一针见血指出根本原因，更提供经过实战验证的“开箱即用”解决方案：升级 surefire 至 3.0.0-M9、Jupiter 引擎与 API 均至 5.9.1，并附关键配置细节、避坑提示（如命名规范、注解来源、多框架干扰）及三步快速验证法，助你彻底告别测试不执行的困扰，实现平滑、零侵入的 JUnit 5 迁移。

本文详解 Maven 3.8.6 环境下 JUnit 5 测试无法执行的常见原因及解决方案，重点解决 surefire 插件版本不兼容、Jupiter 引擎未正确集成等问题，并提供可直接复用的配置示例。

本文详解 Maven 3.8.6 环境下 JUnit 5 测试无法执行的常见原因及解决方案，重点解决 surefire 插件版本不兼容、Jupiter 引擎未正确集成等问题，并提供可直接复用的配置示例。

在 Maven 3.8.6 中运行 JUnit 5 测试失败（如 mvn test -Dtest=TestRunner 无响应或静默跳过），通常并非代码或测试类本身问题，而是构建工具链的版本兼容性缺陷所致。Maven 3.8+ 默认禁用 HTTP 仓库且对插件元数据校验更严格，而旧版 maven-surefire-plugin（如 2.22.0）对 JUnit 5 的原生支持不足，尤其在引擎发现（test engine discovery）和模块路径（module-path）处理上存在已知局限。

✅ 根本解决方案：升级至兼容版本组合
请将 pom.xml 中的 Surefire 插件与 JUnit Jupiter 引擎同步升级为以下经过验证的最新稳定版本：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M9</version> <!-- 或 3.0.0（推荐） -->
    <configuration>
        <includes>
            <include>**/*Test.java</include>
            <include>**/Test*.java</include>
        </includes>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.9.1</version> <!-- 或 5.10.2（最新 LTS） -->
        </dependency>
    </dependencies>
</plugin>

⚠️ 关键注意事项：

• 勿遗漏 JUnit 5 API 依赖：仅声明 junit-jupiter-engine 不足以编译测试类，必须同时添加 junit-jupiter-api（作用域 test）：

  <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>5.9.1</version>
      <scope>test</scope>
  </dependency>

• 避免混合测试框架干扰：若项目中同时存在 TestNG 和 JUnit 5 测试，请确保 TestRunner.java 使用 @Test 注解来自 org.junit.jupiter.api.Test，而非 org.testng.annotations.Test；否则 Surefire 可能因检测到多个引擎而退回到默认行为（如仅执行 TestNG）。
• 验证测试类结构：JUnit 5 测试类无需继承任何基类，但需满足以下任一命名约定（由 Surefire 默认 includes 规则匹配）：
  • 类名以 Test 结尾（如 CalculatorTest.java）
  • 类名以 Tests 结尾（如 IntegrationTests.java）
  • 类名以 TestCase 结尾（如 DatabaseTestCase.java） 若使用自定义名称（如 TestRunner），建议显式配置 或改名以符合规范。

? 快速验证步骤：

1. 执行 mvn clean test-compile 确认测试编译通过；
2. 运行 mvn surefire:test（绕过生命周期钩子，直调 Surefire）观察详细日志；
3. 检查输出中是否包含 Running org.example.TestRunner 及 Tests run: X, Failures: Y —— 成功标志；
4. 如仍失败，追加 -X 参数启用 debug 日志：mvn test -X -Dtest=TestRunner，重点关注 surefire 和 junit-platform 相关行。

总结：Maven 3.8.6 与 JUnit 5 的协同依赖于 Surefire ≥3.0.0 + Jupiter Engine ≥5.8.2 的组合，旧版插件因缺少 JUnit Platform Launcher 集成能力而无法识别 @Test 方法。升级后无需额外配置即可自动启用 Jupiter 引擎，实现零侵入式迁移。

本篇关于《Maven 3.8.6 运行 JUnit 5 测试方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！