更换Android Studio版本后Gradle构建失败无法下载依赖如何解决

• 网络连通性异常：报错核心是TLS握手阶段连接被断开，本质是当前网络无法正常访问Google Maven官方仓库，更换Android Studio版本后，旧版本的依赖缓存、网络配置未自动同步，新安装的AS默认直连Google仓库被拦截，导致依赖拉取失败。
• 代理配置失效：如果你之前旧版本AS配置了全局代理、镜像源，更换版本后相关配置没有迁移到新版本，Gradle使用默认网络规则请求依赖，触发连接断开。
• 版本不兼容：新Android Studio绑定的Gradle版本与你项目原有的Android Gradle Plugin（AGP）版本不匹配，导致依赖拉取规则异常，无法正确识别和下载对应版本的构件。

方案1：替换为国内镜像源（最稳定） #

打开项目根目录下的build.gradle文件，修改构建脚本和全局仓库配置，替换默认的Google、Jcenter仓库为阿里云镜像，示例配置如下：

// 项目根build.gradle配置
buildscript {
    repositories {
        // 注释掉默认的google()、jcenter()，新增阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
    dependencies {
        // 此处保留你原有的AGP等classpath配置即可，无需修改
    }
}

allprojects {
    repositories {
        // 同样替换allprojects下的仓库配置
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

修改完成后点击Android Studio右上角的「Sync Now」按钮同步项目即可。

方案2：同步网络代理配置 #

打开Android Studio的Settings（Mac系统为Preferences），依次进入Appearance & Behavior > System Settings > HTTP Proxy，确认代理配置和旧版本AS的配置一致：如果之前使用系统代理选择「Auto-detect proxy settings」，如果使用手动代理填写正确的地址、端口、认证信息，配置完成后重启AS再同步项目。

方案3：启用离线模式复用缓存 #

如果之前旧版本已经成功构建过该项目，所有依赖都已在本地有缓存，可以打开AS的Settings > Build, Execution, Deployment > Build Tools > Gradle，勾选「Offline work」选项，开启离线模式后同步项目，直接复用本地缓存无需拉取新依赖。

方案4：匹配AGP与Gradle版本 #

你报错的依赖版本对应AGP 3.1.1，需要搭配Gradle 4.4及以上版本，检查项目下gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl配置，确认Gradle版本和AGP版本匹配，若版本不匹配调整为对应版本后再同步。

内容的提问来源于stack exchange，提问作者Ghaith Muhammed