本文详解 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 引擎，实现零侵入式迁移。
