Android Studio Bumblebee新建项目Gradle文件无法同步问题求助

版本校验结论 #

当前版本配置完全符合官方兼容要求，不存在版本不匹配问题：

• Android Gradle Plugin（AGP）7.1.2 官方指定适配的Gradle版本就是7.2，无需修改wrapper.properties和根目录Gradle文件里的版本号。

现有配置如下：
wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

根目录build.gradle（描述中提到的app.gradle为命名混淆，模块级配置存放在app目录下）

plugins {
    id 'com.android.application' version '7.1.2' apply false
    id 'com.android.library' version '7.1.2' apply false
}

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

同步报错截图：

故障原因 #

90%以上该场景报错为网络连接异常导致：国内网络环境无法稳定连接Google Maven仓库、Gradle官方插件仓库，依赖或Gradle包下载超时/连接被重置，其次为残留无效代理配置、Gradle安装包损坏。

修复步骤 #

按顺序操作即可，每步做完可触发一次Gradle同步，无需全部完成：

• 替换国内镜像仓库源
  Bumblebee版本默认把全局仓库配置移到了项目根目录的settings.gradle文件中，打开该文件，将原有仓库配置替换为阿里云镜像源，替换完成的参考配置如下：

pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
}
rootProject.name = "你的项目名"
include ':app'

• 清理无效代理配置
  如果之前开过代理又关闭，大概率是Gradle全局配置残留了无效代理信息。打开Gradle用户目录（Windows默认路径为C:\Users\你的用户名\.gradle，Mac默认路径为~/.gradle），找到目录下的gradle.properties文件，删除所有以systemProp.http.proxy、systemProp.https.proxy开头的配置行，保存后重启Android Studio。
• 校验本地Gradle包完整性
  进入GRADLE_USER_HOME/wrapper/dists/gradle-7.2-bin对应的随机字符串目录，检查已下载的gradle-7.2-bin.zip文件大小是否正常（正常大小约110M），如果文件大小异常、解压报错，直接删除整个gradle-7.2-bin目录，重新触发同步即可重新下载，也可以手动下载对应版本Gradle压缩包放到该目录，避免在线下载超时。
• 关闭Gradle离线模式
  打开File > Settings > Build, Execution, Deployment > Gradle设置页，确认没有勾选Offline work选项，应用配置后重新同步。

内容的提问来源于stack exchange，提问作者Stuti Kasliwal