本文详解 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），建议显式配置
或改名以符合规范。
? 快速验证步骤：
- 执行 mvn clean test-compile 确认测试编译通过；
- 运行 mvn surefire:test（绕过生命周期钩子，直调 Surefire）观察详细日志；
- 检查输出中是否包含 Running org.example.TestRunner 及 Tests run: X, Failures: Y —— 成功标志；
- 如仍失败，追加 -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 引擎，实现零侵入式迁移。
