添加新Jar包后Gradle刷新失败：无法找到hadoop-common依赖

我之前帮同事解决过几乎一模一样的问题，核心原因很明确：CDH版本的Hadoop依赖并不在Spring的milestone仓库（或者默认Maven中央仓库）里，Gradle只会去你配置的仓库列表里搜索，所以才会出现只在Spring仓库找的情况。下面是具体的修复步骤：

• 添加Cloudera专属仓库到build.gradle
  CDH（Cloudera Distribution Including Apache Hadoop）的依赖包是托管在Cloudera自己的Maven仓库里的，必须手动把这个仓库配置到你的Gradle项目中。打开项目根目录下的build.gradle，找到repositories代码块，添加Cloudera仓库：

  repositories {
      mavenCentral()
      maven { url 'https://repo.spring.io/libs-milestone' }
      // 新增Cloudera仓库，用于拉取CDH版本的Hadoop依赖
      maven { url 'https://repository.cloudera.com/artifactory/cloudera-repos/' }
  }
  

• 确认依赖声明的正确性
  检查你的dependencies块里，hadoop-common的坐标是否完全正确，尤其是版本号的cdh5.3.0后缀不能少：

  dependencies {
      implementation 'org.apache.hadoop:hadoop-common:2.5.0-cdh5.3.0'
      // 其他项目依赖...
  }
  

  有时候手误写错版本号或者groupId，也会导致依赖找不到，一定要和你需要的Jar包坐标完全匹配。

• 强制刷新Gradle依赖并清理缓存
  配置完仓库后，需要让Gradle重新拉取依赖：

  1. 在IntelliJ IDEA右侧的Gradle面板中，点击顶部的「刷新所有Gradle项目」按钮（圆形箭头图标）。
  2. 如果还是有问题，执行Gradle命令强制刷新依赖缓存：

     # Linux/Mac
     ./gradlew clean build --refresh-dependencies
     # Windows
     gradlew.bat clean build --refresh-dependencies
     

  3. 若IDEA仍存在方法解析问题，可以尝试清除IDEA的本地缓存：点击「File -> Invalidate Caches...」，选择「Invalidate and Restart」，重启后IDEA会重新索引项目依赖。

• 特殊场景处理（内网/私有仓库环境）
  如果你的开发环境是内网，无法直接访问Cloudera的公共仓库：

  • 可以手动下载hadoop-common:2.5.0-cdh5.3.0.jar，放到本地Maven仓库的对应路径（~/.m2/repository/org/apache/hadoop/hadoop-common/2.5.0-cdh5.3.0/）。
  • 或者联系公司运维，把Cloudera仓库配置到私有代理仓库（比如Nexus、Artifactory）中，然后在build.gradle里配置私有仓库地址即可。

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