Gradle Groovy项目无法导入依赖Jar包类问题排查

• 作为Gradle和Groovy新手，创建了Gradle-Groovy示例项目
• 添加了Maven中央仓库的com.fasterxml.jackson.core:jackson-databind:2.15.1依赖
• Groovy文件中导入com.fasterxml.jackson.databind.ObjectMapper时，构建报错：

unable to resolve class com.fasterxml.jackson.databind.ObjectMapper
@ line 3, column 1.
import com.fasterxml.jackson.databind.ObjectMapper

• 相同依赖在Gradle-Java项目中可正常使用，无构建问题

• 依赖配置作用域错误
  检查build.gradle里的依赖配置，确保依赖放在implementation（或旧版本的compile）块中，而非仅Java专属、测试专属的配置里。正确配置示例：

  dependencies {
      implementation 'com.fasterxml.jackson.core:jackson-databind:2.15.1'
  }
  

• 未应用Groovy插件
  Gradle-Groovy项目必须在build.gradle开头应用Groovy插件，否则Gradle不会处理Groovy源码的编译和依赖路径。确认配置：

  plugins {
      id 'groovy'
      id 'java' // 若需混合Java代码可添加
  }
  

  仅应用Java插件的话，Groovy文件无法被正确编译，依赖也不会关联到Groovy的编译路径。

• 项目结构不符合Gradle默认规范
  Gradle默认Groovy源码路径为src/main/groovy，如果你的Groovy文件放在src/main/java或其他非默认路径，Gradle不会将其识别为Groovy源码。要么把文件移到src/main/groovy，要么手动配置源码路径：

  sourceSets {
      main {
          groovy {
              srcDirs = ['src/main/groovy', 'src/main/java'] // 支持Java和Groovy混合编写
          }
      }
  }
  

• 依赖未正确同步
  手动执行gradle clean build --refresh-dependencies命令，强制Gradle刷新依赖并重新构建，确保依赖包已正确下载到本地仓库。

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