Gradle同步报错：配置优先用settings仓库但Google仓库来自build.gradle.kts

DevOps 小满

2026-7-2

解决Gradle仓库配置冲突报错

问题原因

Android Gradle Plugin（AGP）7.0及以上版本，Gradle默认要求所有仓库配置统一放在settings.gradle.kts中，不再推荐在顶层build.gradle.kts的buildscript或allprojects块里配置仓库。你当前的配置违反了这个规则，所以触发了同步报错。

解决步骤

修改settings.gradle.kts文件
打开项目根目录下的settings.gradle.kts，确保dependencyResolutionManagement块中包含Google和Maven Central仓库（如果没有该块，直接添加）：
```
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "你的项目名称"
include(":app")
```
注：repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)就是报错提示里提到的"prefer settings repositories over project repositories"的配置，它会禁止在项目级build文件里添加仓库。

清理顶层build.gradle.kts的冗余配置
删除顶层build.gradle.kts中的buildscript和allprojects块，修改后的文件如下：

// Top-level build file where you can add configuration options common to all sub-projects/modules.
plugins {
    id("com.android.application") version "8.2.1" apply false
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}