升级Gradle时遇错误：无法解析:app:debugCompileClasspath配置的所有文件

错误信息翻译 #

引发原因：org.gradle.api.internal.artifacts.ivyservice.DefaultLenientConfiguration$ArtifactResolveException: 无法解析配置 ':app:debugCompileClasspath' 的所有文件。

下面是几种常见的解决方案，按优先级尝试：

• 检查仓库配置完整性
  升级Gradle后，仓库配置的位置可能有变化（比如Gradle 7+移到了settings.gradle），确保项目里配置了必要的远程仓库，且没有拼写错误：

  // Gradle 7+ 配置在 settings.gradle
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
          // 如有第三方私有仓库，也需确认地址、认证信息正确
      }
  }
  

  旧版Gradle则在根目录build.gradle中配置：

  allprojects {
      repositories {
          google()
          mavenCentral()
      }
  }
  

• 清理Gradle缓存并强制刷新依赖
  本地缓存的依赖可能损坏，执行以下命令清理并重新拉取依赖：

  ./gradlew clean build --refresh-dependencies
  

  也可以手动删除本地缓存目录彻底清理：

  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：~/.gradle/caches

• 验证Gradle与Android插件版本兼容性
  Gradle版本和Android Gradle插件（AGP）版本必须匹配，不匹配会导致依赖解析失败。参考官方对应关系调整版本：

  Gradle版本	最低AGP版本
  7.0.x	7.0.0
  7.4.x	7.4.0
  8.0.x	8.0.0
  8.1.x	8.1.0

  调整settings.gradle或根build.gradle中的AGP版本：

  plugins {
      id 'com.android.application' version '8.1.0' apply false
  }
  

• 排查网络与代理问题
  依赖无法下载通常和网络有关：

  • 确认网络可以访问Google、Maven Central仓库
  • 检查系统或Gradle的代理配置是否正确，必要时关闭代理尝试
  • 切换到稳定的网络环境（比如手机热点）重新同步

• 检查依赖声明正确性
  核对app/build.gradle中的依赖项，确保groupId、artifactId、版本号没有拼写错误，不存在无效的依赖引用。

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