Gradle无法拉取新依赖，IntelliJ Maven仓库更新报错如何解决？

问题原因确认 #

你遇到的Maven仓库更新报错，是Gradle项目无法更新依赖的直接原因：IntelliJ无法正常读取可用的远程、本地Maven仓库索引，就无法完成依赖包的下载、匹配操作。

修复方案 #

• 排查网络连通性
  先确认当前网络可以正常访问Maven中央仓https://repo1.maven.org/maven2，如果是公司内网存在代理限制，需要在IntelliJ的Preferences > Appearance & Behavior > System Settings > HTTP Proxy中配置符合要求的代理规则，配置完成后点击页面的「Check connection」，测试能否正常连通repo1.maven.org的443端口。
• 清理本地仓库损坏缓存
  本地仓库/Users/paulcarron/.m2/repository报错大概率是存在损坏的缓存标识文件，先关闭IntelliJ，执行以下命令清理残留异常文件：

  find ~/.m2/repository -name "*.lastUpdated" -exec rm -f {} \;
  

  执行完成后重新打开IntelliJ，再次尝试更新仓库索引。
• 替换国内镜像源（可选，针对中央仓访问不稳定的场景）
  在用户目录下的~/.m2/settings.xml中配置阿里云Maven镜像，配置示例如下：

  <mirrors>
      <mirror>
          <id>aliyunmaven</id>
          <mirrorOf>central</mirrorOf>
          <url>https://maven.aliyun.com/repository/public</url>
      </mirror>
  </mirrors>
  

  配置完成后重启IntelliJ，重新加载仓库索引即可。
• 核对Gradle仓库配置
  确认项目根目录下的build.gradle或settings.gradle中配置的仓库地址，和IntelliJ中配置的仓库规则一致，避免Gradle走单独配置的不可用仓库拉取依赖。

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