Java 8项目用JUnit4执行Gradle测试报TestSuiteExecutionException如何解决

问题原因 #

你当前使用的Gradle版本默认采用JUnit Platform（JUnit 5的运行框架）执行测试，但仅引入了JUnit 4的核心依赖，没有为JUnit Platform提供适配JUnit 4的测试引擎，导致运行时找不到可执行测试的引擎实例，抛出对应异常。

解决方案 #

有两种可选方案，按需选择即可：

方案1：配置Gradle使用原生JUnit 4运行器（改动最小，适配现有代码无额外依赖） #

不需要修改已有依赖，直接在build.gradle中添加测试任务配置，指定用JUnit 4运行器执行测试：

test {
    useJUnit()
}

方案2：保留JUnit Platform运行逻辑，添加JUnit 4适配引擎 #

如果后续有升级JUnit 5的需求，或需要兼容JUnit 4、JUnit 5混合编写的测试，在dependencies块中新增JUnit 4适配引擎依赖即可：

dependencies {
    // 原有其他依赖保持不变
    testImplementation 'junit:junit:4.13.2'
    // 新增JUnit 4适配引擎，支持JUnit Platform识别运行JUnit 4测试
    testRuntimeOnly 'org.junit.vintage:junit-vintage-engine:5.8.2'
}

注：5.8.2是适配Java 8的稳定版本，可根据项目实际需求调整版本号。

验证 #

配置完成后执行./gradlew clean test（Windows环境执行gradlew.bat clean test）重新运行测试即可正常执行。

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