IntelliJ中Android项目Gradle无法识别JUnit测试问题

核心背景 #

你的问题本质是Gradle默认未启用JUnit 5测试引擎支持，导致即使引入了JUnit 5依赖，也无法扫描执行标注org.junit.jupiter.api.Test的测试用例；而JUnit 4是Gradle测试任务的默认支持框架，因此切换后能正常运行。

具体原因拆解 #

1. Gradle测试任务的默认引擎限制
   Android Gradle Plugin（AGP）7.4.1对应的Gradle版本，其内置的test单元测试任务默认仅绑定JUnit 4的测试引擎。它只会扫描识别org.junit.Test注解的测试方法，对JUnit 5的org.junit.jupiter.api.Test注解完全无感知，自然不会执行这类测试。

2. 依赖配置缺失关键引擎触发逻辑
   你仅添加了testImplementation 'org.junit.jupiter:junit-jupiter:5.8.1'聚合依赖包，但Gradle需要明确配置启用JUnit Platform才能加载Jupiter引擎。聚合包包含了API和引擎模块，但没有触发Gradle切换测试执行逻辑，所以依然沿用JUnit 4的扫描规则。

3. IDE与Gradle执行机制差异
   IntelliJ直接运行测试（不依赖Gradle任务）时，使用的是IDE自身集成的JUnit 5运行器，绕过了Gradle的默认配置，因此能正常识别并执行JUnit 5测试；但一旦通过Gradle任务（如test或IDE触发的Gradle测试任务）执行，就会遵循Gradle的默认规则，无法识别JUnit 5用例。

解决配置方案 #

要让Gradle支持JUnit 5测试，只需在app模块的build.gradle中补充以下配置：

1. 完善JUnit 5依赖（可选，聚合包也可，但明确配置更清晰）

   dependencies {
       // JUnit 5 API（编写测试用）
       testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
       // JUnit 5运行时引擎（执行测试用）
       testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
       // 可选：参数化测试支持
       testImplementation 'org.junit.jupiter:junit-jupiter-params:5.8.1'
   }
   

2. 配置Gradle测试任务使用JUnit Platform
   在android块中添加测试选项配置：

   android {
       // ... 其他已有配置
       testOptions {
           unitTests {
               all {
                   // 启用JUnit Platform，支持JUnit 5
                   useJUnitPlatform()
               }
           }
       }
   }
   

配置完成后，重新执行Gradle的test任务，就能正常识别并运行JUnit 5的测试用例了。

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