Spring Boot项目Groovy单元测试构建时遇Runtime类找不到异常

问题场景 #

基于Spring Boot的Java API项目，单元测试使用Groovy编写，主代码目录为src/main/java，测试代码目录为src/test/groovy，采用Gradle构建。在IntelliJ IDE中执行build任务时，出现类找不到异常，错误核心信息如下：

Process 'Gradle Test Executor 99' finished with non-zero exit value 1
Error: Could not find or load main class Runtime
Caused by: java.lang.ClassNotFoundException: Runtime

已尝试配置sourceSets及添加Groovy依赖，仍无法解决问题。

解决方案 #

以下是几个容易遗漏的关键配置及排查点：

• 确认Groovy插件已正确应用
  必须在build.gradle中同时应用Java和Groovy插件，Gradle才能处理Groovy测试代码：

  plugins {
      id 'java'
      id 'groovy'
      id 'org.springframework.boot' version 'x.x.x'
      id 'io.spring.dependency-management' version 'x.x.x'
  }
  

  注意替换x.x.x为实际使用的Spring Boot及依赖管理插件版本。

• 检查Groovy依赖的作用域与版本兼容性
  Groovy运行时依赖需添加到测试作用域，且版本要与当前Gradle版本兼容（Gradle 7.x对应Groovy 3.x，Gradle 8.x对应Groovy 4.x）：

  dependencies {
      implementation 'org.springframework.boot:spring-boot-starter-web'
      testImplementation 'org.springframework.boot:spring-boot-starter-test'
      testImplementation 'org.codehaus.groovy:groovy-all:4.0.12' // 示例版本，按需调整
      // 若使用Spock框架，需额外添加：
      // testImplementation 'org.spockframework:spock-core:2.3-groovy-4.0'
  }
  

• 验证sourceSets配置准确性
  确保测试源目录正确指向Groovy代码，若测试目录没有Java代码，可清空Java源路径避免冲突：

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

• 排查测试任务的错误配置
  错误中出现找不到Runtime主类的提示，大概率是测试任务被误配置了main属性，检查并删除此类配置：

  test {
      // 移除类似 main = 'Runtime' 的错误配置
      useJUnitPlatform() // 启用JUnit平台，支持Groovy/Spock测试执行
  }
  

• 清理IntelliJ缓存
  IDE缓存异常也可能导致此类问题：

  • 执行File -> Invalidate Caches...，选择Invalidate and Restart
  • 在Gradle工具窗口点击Refresh all Gradle projects

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