Android项目集成JUnit4单元测试运行崩溃、依赖解析失败问题求助

• JUnit5依赖配置缺失版本号：你在dependencies中声明了两次org.junit.jupiter:junit-jupiter但未指定版本号，Gradle无法定位对应的依赖包，直接触发了依赖解析失败的报错
• 依赖声明冗余：JUnit是测试框架，不需要在implementation层级引入（会被打包到正式APK中），仅需在testImplementation层级声明即可
• 测试框架混用：当前测试类使用JUnit4的org.junit.Test注解，同时引入了未配置完成的JUnit5依赖，存在兼容性隐患；另外继承TestCase是JUnit3的过时写法，也会引发不必要的兼容问题

1. 修正Gradle依赖配置 #

替换你原有的dependencies部分的测试相关配置即可，原有生产依赖保持不变：

dependencies {
    // 原有生产依赖保持不变
    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'com.google.android.material:material:1.4.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.1'
    implementation 'androidx.navigation:navigation-fragment:2.3.5'
    implementation 'androidx.navigation:navigation-ui:2.3.5'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.3.1'
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.3.1'

    // 本地单元测试依赖（JUnit4，与你当前测试类写法匹配）
    testImplementation 'junit:junit:4.13.2'
    // 删除原有的两次JUnit5依赖声明，不需要就完全移除
    // 若需使用JUnit5，参考下方可选配置

    // 设备端instrumentation测试依赖保持不变
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

2. （可选）如需使用JUnit5的配置 #

如果你要切换到JUnit5，除了补全带版本号的JUnit5依赖，还需要添加测试平台配置：
首先在android闭包中添加testOptions配置：

android {
    // 原有android配置保持不变
    testOptions {
        unitTests {
            useJUnitPlatform()
        }
    }
}

再修改dependencies中的测试依赖：

testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'

同时修改测试类的注解导入为org.junit.jupiter.api.Test，删除对TestCase的继承。

3. 优化测试类写法 #

适配JUnit4的最简测试类写法如下，删除过时的TestCase继承即可：

package com.example;

import org.junit.Test;

public class ExampleUnitTest {
    @Test
    public void test() {
        // 填写你的测试逻辑
    }
}

配置修改完成后，同步Gradle再运行测试即可解决问题。

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