【Android Studio】Gradle sync failed in xx s xxx ms；Connect timed out；Could not install Gradle dis解决方案

博主领域：嵌入式领域&人工智能&软件开发

本方案亲测有效解决该问题。建议新手先使用方法2。

目录

解决方案

方法1 自行下载gradle

方法2 使用代理地址

---

问题描述

打开Android Studio会提示下图所示的问题：Connect timed out，通知栏警告信息为：Gradle sync failed in xx s xxx ms

或者出现如下警告信息。

Could not install Gradle distribution from 'https://services8.0-bin.zipThe cached zip file c: Users Archie .gradle wrapper distslgradle-8.0-bin ca5e32bp14vu59qr306oxotwh gradle-8.0-bin.zip may be corruptedDelete file and sync project

或出现如下警告，可能是SDK的环境还没搭建好

Timed out after 300seconds waiting foremulator to come online.

 

原因分析：

“Connect timed out” 等错误通常表示 Android Studio 在与 Gradle 服务器建立连接时超时了。是由于网络问题造成，例如gradle-8.0-bin未成功下载到.gradle目录。因为Gradle，Maven，Google的服务器都在国外，下载速度有限制，会造成超时等等原因。

Android Studio在新建项目后，会分步下载下面两类文件：

1.Gradle的zip文件，如Gradle-8.0.0-bin.zip（一般会报Read Timed Out错误）

2.jar依赖文件（数量比较多大概1000来个，这里下载比较慢）

解决方案

方法1 自行下载gradle

建议新手先尝试使用方法2 使用代理地址。还是不行的话再来方法1+方法2，亲测无误。

1.首先需要查看自己的gradle版本，如下图所示， 打开gradle-wrapper.properties文件，可以看到distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip，则我的gradle版本为gradle-8.0-bin.zip

2.下载一个gradle，和自己的版本保持一致，例如我的是下载gradle-8.0-bin.zip。分享一个快速下载链接：Index of /gradle/    

3. 首先，先将gradle默认目录。C:\Users\Archie（你的用户名）\.gradle\wrapper\dists目录下的文件全部删除。

 4.然后关闭当前的工程，点击File>Close Project。同时你可以看到在第3步删除的文件又出现了。有个乱码名称的文件夹出现了。

4.将下载好的gradle-8.0-bin.zip（你自己的版本），放在如下所示目录下，C:\Users\Archie\.gradle\wrapper\dists\gradle-8.0-bin\ca5e32bp14vu59qr306oxotwh  

5.返回Android Studio页面，发现问题解决则可以不用继续看后面步骤，若是第一次使用的话，会继续下载很久文件，耐心等待，然后可以看到模式的图标出现（如下红框中）。若还不行继续后面方法。

若出现如下错误警告，可以尝试步骤6和7

Timed out after 300seconds waiting foremulator to come online.

6.加入 Android SDK HOME 系统变量，值为SDK的路径

7.下载全面需要的SDK 

方法2 使用代理地址

​​​​​第一类（使用的是旧的构建语言.gradle）：

1.新建一个项目 ，(修改语言为java,构建语言为DSL，选择完成)

2.修改build.gradle.kts里面代码。

 图中代码如下所示

// Top-level build file where you can add configuration options common to all sub-projects/modules.

//原来的
//plugins {
//    id("com.android.application") version "8.1.3" apply false
//}


//修改后的
buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/google'}
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin'}
        maven { url 'https://maven.aliyun.com/repository/public'}
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.3'   //注意这里8.1.3根据你的情况而定
    }
}

3.修改gradle-wrapper.properties处的代码

图中代码如下所示

#Sat Jan 06 19:39:31 CST 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists

//原来的
//distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
//现在的
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

4.记得选择JAVA_HOME，同时上面的gradle地址填写详细。

 Sync Now后，成功启动！ 

 ​​​​​第二类 使用的是新的构建语言.kts：

1.相比较第一类，区别如下所示：

2.记得选择JAVA_HOME，同时上面的gradle地址填写详细。

3.修改gradle目录下的gradle-wrapper.properties处的代码

 代码如下：

#Sun Jan 07 17:15:18 CST 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists

//原来的
//distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip

//现在的
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

4.修改gradle目录下的settings.gradle.kts处代码，然后选择Sync Now就可以了，同样速度起飞： 

修改代码如下：

pluginManagement {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/public/") }
        maven { url = uri("https://maven.aliyun.com/repositories/jcenter") }
        maven { url = uri("https://maven.aliyun.com/repositories/google") }
        maven { url = uri("https://maven.aliyun.com/repositories/central") }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/public/") }
        maven { url = uri("https://maven.aliyun.com/repositories/jcenter") }
        maven { url = uri("https://maven.aliyun.com/repositories/google") }
        maven { url = uri("https://maven.aliyun.com/repositories/central") }
        google()
        mavenCentral()
    }
}

Sync Now后，成功启动！ 

参考链接：

 解决Gradle sync failed: Gradle Sync Issues问题（Android开发/Android Studio）-CSDN博客

安卓开发-Android Studio(2022.3.1)-新建项目下载报错,速度慢,最终解决办法，小白教程一路顺利_android studio could not initialize class org.grad-CSDN博客

个人主页：阿齐Archie

 个人vx公众呺：阿齐Archie