Gradle JUnit测试报错ClassNotFoundException问题求助

问题场景 #

已在Gradle项目中配置JUnit 5依赖及测试任务：

dependencies {
    testImplementation('org.junit.jupiter:junit-jupiter:5.8.2')
    testRuntimeOnly('org.junit.jupiter:junit-jupiter-engine:5.8.2')
 }

 test {
    systemProperties 'property': 'value'
    useJUnitPlatform()    

    filter {
      excludeTestsMatching "com.xxx.xxx.*"
      includeTestsMatching "com.xxx.sfTasks.*"
    }
   
  }

测试类尝试实例化主源码中的XXXCustomDdExtractTask类时，执行gradle test命令出现如下错误：

> Task :test
XXXCustomDdExtractTaskTest > test() FAILED
java.lang.NoClassDefFoundError at XXXCustomDdExtractTaskTest.java:16
 Caused by: java.lang.ClassNotFoundException at XXXCustomDdExtractTaskTest.java:16

排查与解决步骤 #

• 检查主类的源码目录配置
  确认XXXCustomDdExtractTask类是否放在Gradle默认主源码目录（src/main/java）下，若使用自定义目录，需在build.gradle中配置sourceSets：

  sourceSets {
      main {
          java {
              srcDirs = ['src/custom/main/java']
          }
      }
  }
  

• 验证主类编译状态
  执行gradle compileJava命令，检查编译是否成功，查看build/classes/java/main目录下是否生成了XXXCustomDdExtractTask对应的.class文件，若编译失败先修复主类代码错误。

• 确保测试任务依赖主编译任务
  默认test任务依赖compileJava，但自定义任务关系可能导致主类未编译就执行测试，可显式指定依赖：

  test.dependsOn compileJava
  

• 核对类包路径一致性
  检查测试类中导入XXXCustomDdExtractTask的包路径，与主类实际包路径完全匹配，避免因包名拼写错误导致类找不到。

• 清理缓存后重新构建
  执行gradle clean test命令，清理旧编译产物后重新运行测试，排除缓存文件引发的类加载异常。

• 多模块项目需配置跨模块依赖
  若XXXCustomDdExtractTask在其他模块，需在测试模块的build.gradle中添加模块依赖：

  dependencies {
      implementation project(':xxx-target-module')
      // 保留原有JUnit依赖配置
      testImplementation('org.junit.jupiter:junit-jupiter:5.8.2')
      testRuntimeOnly('org.junit.jupiter:junit-jupiter-engine:5.8.2')
  }
  

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