本文详解如何正确配置 Android Studio 的 build.gradle 文件，修复因 Gradle 插件版本、仓库源冲突（如 google() 与 settings repositories 冲突）导致的构建失败问题，并提供兼容性强、符合现代 Android 构建规范的依赖管理方案。

本文详解如何正确配置 android studio 的 `build.gradle` 文件，修复因 gradle 插件版本、仓库源冲突（如 `google()` 与 settings repositories 冲突）导致的构建失败问题，并提供兼容性强、符合现代 android 构建规范的依赖管理方案。

在 Android Studio 新项目中遇到 app process Debug Resource failure 或构建报错提示 “build was configured to prefer settings repositories but repository google was added by build file”，本质是 Gradle 构建系统对仓库声明方式的严格校验升级所致——自 Android Gradle Plugin (AGP) 7.0+ 起，官方强制推荐将仓库配置统一移至 settings.gradle（或 settings.gradle.kts），而非在 build.gradle 中重复声明 google()、mavenCentral() 等。若 settings.gradle 已启用 pluginManagement 或 dependencyResolutionManagement 并声明了仓库，而 build.gradle 又显式调用 google()，就会触发该冲突错误。

✅ 正确做法是分离职责：

• settings.gradle 负责全局仓库与插件源配置；
• build.gradle（Project 级）仅保留必要的 buildscript 依赖声明（且需确保仓库不重复）；
• build.gradle（Module 级）专注模块依赖（implementation、api 等）。

但若你暂未迁移至 settings.gradle 管理仓库（例如使用较旧模板），可按以下安全方案快速修复：

✅ 推荐修复版 build.gradle（Project 级）

// 注意：此为 Project 级 build.gradle（位于项目根目录）
buildscript {
    repositories {
        google()
        mavenCentral() // ✅ 替代已弃用的 jcenter()（2021 年关停）
        // jcenter() // ⚠️ 不再推荐，保留仅作兼容，建议尽快移除
        maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2'
        classpath 'com.google.gms:google-services:4.3.15' // 如需 Firebase/GMS 服务
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
        // jcenter() // ⚠️ 强烈建议删除，避免警告与未来构建失败
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

? 关键注意事项：

• jcenter() 已于 2021 年 2 月正式关停，继续使用可能导致依赖拉取失败。请优先切换至 mavenCentral() 或对应官方仓库（如 Jetpack 库默认由 google() 提供）。
• 若项目已启用 settings.gradle 中的 dependencyResolutionManagement（新项目默认启用），必须删除 build.gradle 中所有 repositories 块，否则必然冲突。此时应将全部仓库统一写入 settings.gradle：

  // settings.gradle
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
          maven { url 'https://jitpack.io' }
      }
  }

• buildscript.classpath 中的 gradle 插件版本（如 7.4.2）必须与当前 Android Studio 版本兼容。建议查阅 AGP 版本对应表 选择匹配版本。
• 清理缓存后重试：执行 ./gradlew clean + File → Invalidate Caches and Restart → Invalidate and Restart。

遵循以上配置，即可彻底解决 Debug Resource failure 及仓库冲突报错，确保构建流程稳定、可维护，并符合 Android 官方最佳实践。