Android Studio 解决 Gradle Sync 报错：Could not install Gradle distribution 下载超时问题

问题描述在 Android Studio 中新建项目或同步项目时经常遇到 Gradle 同步失败Gradle Sync failed的报错。控制台Build - Sync会提示如下错误信息Could not install Gradle distribution from https://services.gradle.org/distributions/gradle-9.6.0-bin.zip. Reason: java.net.SocketTimeoutException: Connect timed out原因分析这是典型的网络问题。Android Studio 默认从 Gradle 官方服务器services.gradle.org下载 Gradle 构建工具由于国内网络环境限制连接极不稳定导致请求超时Connect timed out。️ 解决方案以下提供三种最有效的解决方法推荐优先尝试方案一。方案一修改 Gradle 下载镜像源最推荐最快捷将官方下载地址替换为国内的镜像服务器可以大幅提升下载速度并避免超时。操作步骤在 Android Studio 左侧目录树中将项目视图切换为Project模式。依次展开项目目录找到并双击打开gradle-wrapper-gradle-wrapper.properties文件。找到distributionUrl这一行将原来的官方链接替换为国内镜像。原来的官方链接distributionUrlhttps\://services.gradle.org/distributions/gradle-9.6.0-bin.zip修改为国内镜像任选其一阿里云镜像distributionUrlhttps\://mirrors.aliyun.com/macports/distfiles/gradle/gradle-9.6.0-bin.zip腾讯云镜像distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-9.6.0-bin.zip修改完成后点击右上角出现的“Sync Now”或者点击上方工具栏的大象图标Sync Project with Gradle Files重新同步即可。注意如果你的报错版本不是9.6.0请将上述链接中的9.6.0替换为你实际需要的版本号。方案二手动下载并配置 Gradle适合镜像也下载慢的情况如果通过 IDE 下载依然慢如蜗牛可以使用浏览器或下载工具如迅雷手动下载。操作步骤手动下载使用浏览器复制镜像链接如上述阿里云或腾讯云链接直接下载gradle-x.x.x-bin.zip压缩包。找到本地缓存目录在电脑中打开以下路径C:\Users\你的用户名\.gradle\wrapper\dists\gradle-9.6.0-bin\替换文件在该目录下会看到一个名字是乱码随机字符的文件夹。打开该文件夹把你手动下载好的.zip压缩包直接复制进去如果里面有半截的.part或.lck文件可以删掉。重启同步回到 Android Studio点击“Try Again”重新同步。方案三指定本地已解压的 Gradle 目录针对已下载解压的用户如果你已经下载并解压了 Gradle 包可以通过 IDE 直接指定。操作步骤点击菜单栏File-Project Structure...快捷键CtrlAltShiftS。在左侧列表选择Build, Execution, Deployment-Build Tools-Gradle。在右侧面板的Use Gradle from选项中选择Specified location。点击右侧文件夹图标选择你本地解压后的 Gradle 文件夹路径点击Apply-OK。 避坑提示很多新手遇到下载超时会去点File-Project Structure...注意这个窗口里是无法修改distributionUrl下载链接的必须去gradle-wrapper.properties文件中修改。 其他排查建议关闭网络代理/VPN如果你开启了科学上网工具请尝试暂时关闭或者将 Android Studio 的代理模式设置为No proxy在File - Settings - Appearance Behavior - System Settings - HTTP Proxy中设置。清理缓存如果仍然报错可以尝试File-Invalidate Caches / Restart清理一下 IDE 缓存后重启。希望这篇文章能帮到遇到同样问题的同学如果你觉得有用欢迎点赞收藏