1. 问题背景与常见症状
在android studio开发过程中，开发者可能会突然遇到gradle构建失败的问题，即使之前项目运行正常，或者新建项目也无法构建。这类问题通常表现为以下错误信息：
Plugin [id: 'com.android.application', version: '7.2.2', apply: false] was not found in any of the following sources:
- Plugin Repositories (could not resolve plugin artifact 'com.android.application:com.android.application.gradle.plugin:7.2.2')
Searched in the following repositories:
Gradle Central Plugin Repository
Google
MavenRepo这表明Gradle无法从其配置的默认仓库（如Gradle Central Plugin Repository、Google Maven、Maven Central）中找到或下载所需的插件或依赖项。尽管尝试了多种常规排查方法，如创建新项目、更改Java版本、更改Gradle版本、清理缓存并重启Android Studio（Invalidate Caches / Restart），问题依然存在。
2. 根本原因分析：网络限制
经过排查，这类问题的根本原因往往与网络环境有关。在某些地区或网络条件下，对Gradle默认使用的官方Maven仓库（如services.gradle.org、maven.google.com、repo1.maven.org/maven2）的访问可能会受到限制、阻断或速度缓慢，导致Gradle无法及时或完全地下载所需的插件和依赖。当Gradle无法解析这些资源时，就会抛出“插件未找到”或“无法解析依赖”的错误。
3. 解决方案：配置替代Maven仓库
解决此问题的有效方法是配置能够稳定访问的替代Maven仓库，通常是国内的镜像仓库，例如阿里云Maven仓库。这些镜像仓库同步了官方仓库的内容，但在国内访问速度更快，且不受国际网络限制的影响。
3.1 配置位置
Gradle项目的仓库配置主要在以下两个文件中进行：
-
settings.gradle (推荐用于现代Gradle项目)：用于配置插件和依赖的全局解析策略。
- pluginManagement 块：配置插件的查找仓库。
- dependencyResolutionManagement 块：配置项目依赖的查找仓库。
- 根目录下的 build.gradle (项目级别)：在 allprojects 或 subprojects 块中配置，对所有模块或子模块生效。
考虑到现代Gradle项目的最佳实践，我们优先在 settings.gradle 中进行配置。
3.2 示例代码：阿里云Maven仓库配置
请按照以下步骤修改您的Gradle配置文件：
步骤一：修改 settings.gradle 文件
找到您项目根目录下的 settings.gradle 文件，并添加或修改 pluginManagement 和 dependencyResolutionManagement 块中的 repositories 配置。建议将阿里云镜像仓库放在列表的顶部，以确保Gradle优先从这些仓库中查找资源。
// settings.gradle
pluginManagement {
repositories {
// 添加阿里云Maven仓库，优先解析
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
// 保留原有的官方仓库，作为备用
gradlePluginPortal()
google()
mavenCentral()
}
}
dependencyResolutionManagement {
// 根据需要调整 repositoriesMode，这里保持原样或根据项目需求调整
// repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) // 如果设置为此，则子项目的build.gradle中不能再定义仓库
repositories {
// 添加阿里云Maven仓库，优先解析
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
// 保留原有的官方仓库，作为备用
google()
mavenCentral()
}
}
rootProject.name = "MyTest"
include ':app'步骤二：修改根目录下的 build.gradle 文件 (可选/兼容旧项目)
对于一些旧项目或特定配置，可能需要在根目录下的 build.gradle 文件中的 allprojects 块中也添加仓库配置。这确保了所有模块都能访问这些仓库。
// build.gradle (项目根目录)
// Top-level build file where you can add configuration options common to all sub-projects/modules.
plugins {
id 'com.android.application' version '7.2.1' apply false
id 'com.android.library' version '7.2.1' apply false
id 'org.jetbrains.kotlin.android' version '1.7.10' apply false
}
// 在 allprojects 块中添加仓库配置
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
google()
mavenCentral()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}重要提示：
- 顺序很重要：将镜像仓库放在官方仓库之前，确保Gradle优先尝试从镜像下载。
- repositoriesMode：settings.gradle 中的 dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) } 设置意味着Gradle将不允许在子项目的 build.gradle 中定义仓库。在这种情况下，所有依赖仓库都必须在 settings.gradle 中统一配置。如果您的项目有此设置，请确保 settings.gradle 中的仓库配置是完整的。
3.3 同步Gradle
完成上述修改后，请点击Android Studio工具栏中的“Sync Project with Gradle Files”按钮（通常是一个大象图标），让Gradle重新同步项目。如果配置正确，Gradle应该能够成功下载所需的插件和依赖，并完成构建。
4. 注意事项与总结
- 网络环境检测：在遇到类似问题时，首先考虑网络环境是否对常用开发资源（如GitHub、Maven仓库）存在访问障碍。
- 缓存清理：即使配置了新的仓库，有时Gradle的旧缓存仍可能导致问题。在修改仓库配置后，执行“File -> Invalidate Caches / Restart...”并选择“Invalidate and Restart”是一个好习惯。
- Gradle版本与Android Gradle Plugin (AGP) 版本兼容性：确保您的Gradle版本和AGP版本相互兼容。虽然本文的解决方案主要针对网络问题，但版本不兼容也可能导致构建失败。
- 其他镜像选择：除了阿里云，国内还有腾讯云Maven、华为云Maven等其他镜像仓库可供选择，您可以根据自己的网络环境和偏好进行尝试。
通过合理配置Maven仓库，可以有效解决因网络限制导致的Android Studio Gradle构建失败问题，确保开发流程的顺畅进行。这不仅提高了开发效率，也使得项目在不同网络环境下更具鲁棒性。
