运行JUnit测试报junit-jupiter引擎无法发现测试异常如何解决

你遇到的TestEngine with ID 'junit-jupiter' failed to discover tests异常，本质是JUnit Jupiter测试引擎在启动扫描测试类的阶段，遇到阻断性错误导致无法完成测试用例识别，结合你使用5.5.2版本Jupiter、测试类直接放在test/java根目录的场景，常见诱因如下：

• 测试类路径不合法：Java不推荐把类直接放在默认包（即无package声明的根路径）下，JUnit 5.5.x版本的类扫描器加载默认包下的测试类时，会出现类解析异常直接中断扫描流程，这是你当前场景最高概率的诱因。
• 依赖不匹配或冲突：JUnit 5分为Platform、Jupiter、Vintage三个模块，同版本的Jupiter必须搭配对应版本的Platform模块使用，如果项目中存在JUnit 4残留依赖、框架自带的JUnit版本和你手动指定的5.5.2版本冲突，或者缺少junit-jupiter-engine、junit-platform-launcher等必要依赖，会导致引擎初始化失败。
• 测试类不符合识别规则：测试类非public修饰、为抽象类/内部类、测试方法误用JUnit4的@Test注解、类路径下存在编译错误的损坏class文件，都会导致类加载阶段失败。
• 构建插件配置错误：Maven Surefire/Failsafe插件版本低于2.22.0时原生不支持JUnit 5，或者测试扫描路径配置错误，会导致引擎无法被正常调用。

1. 优先修正测试类存放路径
   不要把测试类直接放在test/java根目录，新建和主代码对齐的包结构，例如test/java/com/yourbiz/mytest/，将测试类移动到该路径下，在类顶部添加正确的包声明package com.yourbiz.mytest;，重新编译后再尝试运行。
2. 校准依赖配置
   以Maven配置为例，5.5.2版本的Jupiter必须搭配1.5.2版本的JUnit Platform模块，完整依赖配置参考如下，所有JUnit相关依赖的scope统一设为test：

   <properties>
       <junit.jupiter.version>5.5.2</junit.jupiter.version>
       <junit.platform.version>1.5.2</junit.platform.version>
   </properties>
   <dependencies>
       <dependency>
           <groupId>org.junit.jupiter</groupId>
           <artifactId>junit-jupiter-api</artifactId>
           <version>${junit.jupiter.version}</version>
           <scope>test</scope>
       </dependency>
       <dependency>
           <groupId>org.junit.jupiter</groupId>
           <artifactId>junit-jupiter-engine</artifactId>
           <version>${junit.jupiter.version}</version>
           <scope>test</scope>
       </dependency>
       <dependency>
           <groupId>org.junit.platform</groupId>
           <artifactId>junit-platform-launcher</artifactId>
           <version>${junit.platform.version}</version>
           <scope>test</scope>
       </dependency>
   </dependencies>
   

   执行依赖分析命令排查冲突：Maven环境执行mvn dependency:tree，Gradle环境执行./gradlew dependencies，搜索结果中所有非1.5.2版本的JUnit Platform、非5.5.2版本的JUnit Jupiter依赖，全部通过exclude规则排除。如果项目引入了Spring Boot等自带JUnit依赖的框架，优先使用框架BOM里声明的JUnit版本，不要手动指定不匹配的版本。
3. 校验测试类合法性
   • 确认测试类是public修饰的顶级普通类，不是抽象类、接口、非静态内部类
   • 确认测试方法上的@Test注解导入自org.junit.jupiter.api.Test包，不要误用JUnit4的org.junit.Test
   • 执行clean命令清空历史编译产物：Maven执行mvn clean test，Gradle执行./gradlew clean test，排除旧的损坏class文件干扰。
4. 校准构建插件配置
   Maven环境下确保surefire插件版本不低于2.22.2，低版本插件无法兼容JUnit 5，配置参考：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-surefire-plugin</artifactId>
       <version>2.22.2</version>
   </plugin>
   

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