运行App时Gradle版本构建失败：无法找到com.android.tools.build:gradle:8.6.0

问题详情 #

执行assembleDebug任务时构建失败，退出码1，核心错误信息如下：

FAILURE: 构建因异常失败。
配置根项目 'android' 时出现问题。
无法解析配置 ':classpath' 的所有文件。
找不到 com.android.tools.build:gradle:8.6.0。
已在以下位置搜索：

• https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle/8.6.0/gradle-8.6.0.pom
• https://repo.maven.apache.org/maven2/com/android/tools/build/gradle/8.6.0/gradle-8.6.0.pom
  被以下项目依赖：project :

解决方案 #

1. 确认插件版本有效性 #

Gradle插件8.6.0可能未正式发布或版本号输入错误，建议使用当前稳定可用的版本（如8.5.0），版本需与项目使用的Gradle版本匹配。

2. 修正根项目构建配置 #

打开根目录下的build.gradle（或build.gradle.kts），确保仓库和依赖配置正确：

buildscript {
    repositories {
        google() // 必须配置Google仓库，Android插件优先从此获取
        mavenCentral()
    }
    dependencies {
        // 替换为存在的稳定版本
        classpath "com.android.tools.build:gradle:8.5.0"
    }
}

3. 同步并清理缓存 #

• 在Android Studio中执行File > Sync Project with Gradle Files，重新同步项目
• 运行命令清理缓存并刷新依赖：

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

4. 检查网络环境 #

确保网络可正常访问Google Maven仓库与Maven Central，受限环境下可配置代理或国内镜像仓库。

内容的提问来源于stack exchange，提问作者Code With Jeet