Gradle构建失败：无法解析类路径依赖，求解决方案

问题描述 #

构建过程中出现异常，配置根项目 'android' 时出错，无法解析配置 ':classpath' 的所有文件，找不到以下依赖包：

无法解析配置 ':classpath' 的所有文件。
找不到 sdk-common-30.1.2.jar（com.android.tools:sdk-common:30.1.2）
找不到 repository-30.1.2.jar（com.android.tools:repository:30.1.2）
找不到 gradle-api-7.1.2.jar（com.android.tools.build:gradle-api:7.1.2）
找不到 builder-test-api-7.1.2.jar（com.android.tools.build:builder-test-api:7.1.2）
找不到 ddmlib-30.1.2.jar（com.android.tools.ddms:ddmlib:30.1.2）
找不到 aaptcompiler-7.1.2.jar（com.android.tools.build:aaptcompiler:7.1.2）
找不到 bundletool-1.8.0.jar（com.android.tools.build:bundletool:1.8.0）
找不到 aapt2-proto-7.1.2-7984345.jar（com.android.tools.build:aapt2-proto:7.1.2-7984345）
找不到 crash-30.1.2.jar（com.android.tools.analytics-library:crash:30.1.2）

解决方法 #

• 检查网络连接
  确保网络可正常访问Google Maven仓库，受限环境下切换稳定网络或配置代理。

• 确认仓库配置
  打开项目根目录的build.gradle，确保buildscript块包含Google和Maven Central仓库：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath "com.android.tools.build:gradle:7.1.2"
      }
  }
  

  必须包含google()，这些Android工具类库仅在此仓库发布。

• 清理Gradle缓存并重新下载依赖
  执行命令清理缓存，强制刷新依赖：

  # macOS/Linux
  ./gradlew clean build --refresh-dependencies
  
  # Windows
  gradlew clean build --refresh-dependencies
  

• 更新插件与Gradle版本
  旧版本可能存在版本下架问题，更新到兼容稳定版：

  1. 修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本（7.1.2插件建议搭配7.2+版本）：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-all.zip
     

  2. 更新build.gradle中的插件版本，例如：

     classpath "com.android.tools.build:gradle:7.4.2"
     

• 验证依赖版本可用性
  确认依赖版本是否存在，若版本已被移除，替换为同系列的稳定可用版本。

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