Eclipse列出单元测试但未实际运行JUnit测试的修复方法

在Apache Jackrabbit项目中运行指定JUnit测试时，Eclipse走完测试运行全流程，但测试从未实际执行，调试器断点始终不触发，最终结果显示8个测试中0个被运行，且未报告任何错误。

• 涉及测试类：jackrabbit-spi2dav模块下的org.apache.jackrabbit.spi2dav.ConnectionTest
• 异常特征：测试运行结束后，无成功、失败标识，也未显示被显式跳过，源码中无任何标记测试跳过的逻辑
  

该表现是典型的JUnit运行器版本与测试类适配版本不匹配，classpath缺少兼容组件导致的，结合Jackrabbit项目的版本特征，触发逻辑如下：

• 高版本Eclipse默认优先选用JUnit 5（JUnit Platform）作为全局默认测试运行器
• 该版本Jackrabbit的ConnectionTest是纯JUnit 3/JUnit 4风格实现，未适配JUnit 5 API
• 若项目classpath中未引入junit-vintage-engine（JUnit5官方提供的、用于兼容执行JUnit3/4用例的引擎），JUnit Platform启动后可以扫描到类中声明的测试方法总数（因此显示"共8个测试"），但没有可用引擎实际执行这些方法，也不会抛出显性报错，最终就会出现"0个测试运行"的结果
• 由于测试方法从未被执行引擎加载，调试断点自然不会触发。

其余两个小概率触发场景：

• 项目编译输出目录配置错误：Eclipse未将最新的测试源码编译到运行时类路径下，运行器加载到的是旧的、不包含可执行测试方法的class文件
• 测试类上@RunWith注解指定的自定义运行器初始化失败，异常被Eclipse JUnit启动层吞掉，未打印到控制台

• 手动指定运行器版本：右键测试类 -> Run As -> Run Configurations，找到对应测试的运行条目，将Test runner选项手动切换为JUnit 4后重新运行，该方案对老版本开源项目适配成本最低
• 若必须使用JUnit 5运行器，检查项目依赖配置，确认test作用域下已引入junit-vintage-engine兼容组件，Maven配置参考如下：

<dependency>
    <groupId>org.junit.vintage</groupId>
    <artifactId>junit-vintage-engine</artifactId>
    <scope>test</scope>
</dependency>

• 清理编译缓存：点击Eclipse顶部菜单Project -> Clean，选中对应项目触发全量重编译，排除旧class文件导致的识别异常
• 校验构建路径配置：右键项目 -> Build Path -> Configure Build Path，确认src/test/java目录被标记为测试源码目录，输出路径与主源码路径隔离

老项目不要依赖Eclipse的JUnit版本自动选择逻辑，手动匹配项目依赖的JUnit主版本是最稳定的方案。

内容的提问来源于stack exchange，提问作者Graham Leggett