无法通过Java Test Runner运行JUnit 5测试的排查求助

环境与配置信息 #

• 运行环境：Docker容器内的自定义VSCode（浏览器访问）
• 相关组件版本：
  • Java 17（Red Hat Language Support for Java(TM) v1.35.1）
  • Debugger for Java v0.56.2
  • Test Runner for Java v0.40.1
  • Gradle for Java v3.13.2023120800

Gradle依赖配置 #

testImplementation 'org.junit.jupiter:junit-jupiter:5.12.0'
testImplementation 'org.junit.platform:junit-platform-launcher:1.12.0'

测试代码 #

package platform.demo.unittest;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {
    @Test
    public void testAddition() {
        int result = 2 + 3;
        assertEquals(5, result, "2 + 3 should equal 5");
    }
}

VSCode设置（settings.json） #

"java.test.config": { "name": "testconfig", "vmArgs": [ "-Dremoting.location=/home/myconnector/remoting.xml" ] }, "java.test.defaultConfig": "testconfig"

报错信息 #

java.util.ServiceConfigurationError：找不到org.junit.vintage.engine.VintageTestEngine

问题分析 #

1. Vintage引擎的定位：JUnit Vintage Engine是JUnit 5用来兼容JUnit 3/4测试的组件，你的项目只使用JUnit 5，本不需要该引擎。报错的核心原因是：测试运行路径中存在注册Vintage引擎的服务配置，但对应的类文件缺失。
2. 触发场景：
   • VSCode的Java Test Runner扩展默认会扫描所有可用的JUnit引擎实现，即使项目没有依赖，也会尝试加载Vintage引擎。
   • Docker容器环境可能残留旧的JUnit配置文件（如META-INF/services/org.junit.platform.engine.TestEngine），其中包含Vintage引擎的注册条目，但缺少对应jar包。
   • Gradle缓存或容器内依赖目录存在旧的JUnit相关残留文件。

解决思路 #

1. 显式排除Vintage引擎 #

在Gradle依赖中直接排除Vintage引擎，避免扩展尝试加载：

testImplementation('org.junit.jupiter:junit-jupiter:5.12.0') {
    exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}

2. 清理VSCode测试配置 #

• 检查settings.json是否存在强制启用Vintage引擎的配置，若有则禁用；也可临时删除自定义的java.test.config配置，测试是否是参数导致的问题。
• 打开VSCode的测试面板，刷新测试列表，清除旧的测试缓存。

3. 清理容器内的依赖缓存 #

• 执行Gradle命令清理缓存并重新构建：

  ./gradlew clean build --refresh-dependencies
  

• 删除容器内~/.gradle/caches目录下的JUnit相关缓存文件，彻底清除残留依赖。

4. 检查并修正服务配置文件 #

• 查看项目src/test/resources/META-INF/services目录，若存在org.junit.platform.engine.TestEngine文件，删除其中org.junit.vintage.engine.VintageTestEngine的条目，仅保留：

  org.junit.jupiter.engine.JupiterTestEngine
  

5. 调整Java Test Runner版本 #

当前使用的v0.40.1可能存在兼容性问题，尝试升级到最新稳定版，或降级到v0.39.x版本，验证是否解决引擎加载异常。

内容的提问来源于stack exchange，提问作者Vijji 32