Gradle测试出现NoClassDefFoundError问题求助

1. 修正测试依赖配置范围 #

确保Mockito、JUnit及onebiz:datastore_testing这类依赖用testImplementation声明（旧Gradle版本可用testCompile），testRuntimeOnly仅适合JUnit引擎这类只在运行时需要的依赖——如果核心测试依赖只加在testRuntimeOnly，会导致编译阶段找不到类、运行时触发NoClassDefFoundError。

示例正确配置：

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
    testImplementation 'org.mockito:mockito-core:4.11.0'
    testImplementation 'com.example:onebiz:datastore_testing:1.0.0' // 替换为实际版本
}

2. 刷新依赖并清理构建 #

• 在IntelliJ里点Gradle工具窗口的刷新箭头（大象图标旁），或者执行命令：

  ./gradlew clean build --refresh-dependencies
  

• 清理IntelliJ缓存：File -> Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart

3. 查看完整测试运行时依赖树 #

别再用./gradlew dependencies看单独的testRuntimeOnly，执行下面的命令看测试运行时完整依赖集合：

./gradlew dependencies --configuration testRuntimeClasspath

这个命令会列出testImplementation+testRuntimeOnly的所有依赖，确认你的测试依赖是否在列表里。

4. 对齐JDK与Gradle版本 #

Gradle 6.0及以上才完全支持JDK11，如果你用的是旧版本，修改gradle/wrapper/gradle-wrapper.properties里的distributionUrl升级Gradle。同时在IntelliJ里检查：

• File -> Project Structure -> Project的SDK选JDK11
• 同窗口下Modules里的模块SDK也要和项目SDK一致

5. 确认测试类目录结构 #

如果无法导入项目自身类，检查测试类是否在src/test/java目录下（主代码对应src/main/java）——Gradle默认会把主代码类暴露给这个目录的测试类。如果自定义了源集，要在build.gradle里明确配置：

sourceSets {
    test {
        java.srcDirs = ['src/test/java']
        resources.srcDirs = ['src/test/resources']
    }
}

错误堆栈快速定位 #

如果错误堆栈类似：

java.lang.NoClassDefFoundError: com/example/onebiz/datastore/TestingUtils
    at com/example/MyTest.testMethod(MyTest.java:15)
    ...

直接对应onebiz:datastore_testing依赖未被正确引入，回到步骤1和2重新检查配置并刷新依赖。

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