Android Studio 3.1升级后构建报Gateway Time-out错误求助

嘿，这个问题我之前帮不少开发者踩过坑——升级AS 3.0.1到3.1、Gradle 4.1到4.6后遇到的commons-codec-1.6.jar 504网关超时，本质是jcenter仓库已经停止维护，访问稳定性极差，再加上网络环境波动就容易触发这类问题。给你几个按优先级排序的解决方案，一步步来：

1. 替换jcenter为官方推荐的仓库（最核心的解决办法） #

jcenter早在2021年就归档停止更新了，Google官方现在推荐用mavenCentral()替代。如果国内访问慢，还可以搭配国内镜像仓库加速：

打开项目根目录的Project级build.gradle，修改repositories块：

buildscript {
    repositories {
        google()
        mavenCentral()
        // 可选：添加阿里云镜像加速国内访问
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
    }
    // ...其他配置
}

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

同时记得把Module级build.gradle里的jcenter()也一并替换掉。

2. 清理Gradle缓存，避免损坏文件干扰 #

有时候本地缓存的依赖文件损坏，也会导致构建时反复请求远程仓库：

• 先关闭Android Studio
• 找到Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux：~/.gradle/caches
• 删除整个caches文件夹（不用担心，下次构建会自动重新下载所需依赖）
• 重新打开AS，点击顶部工具栏的「Sync Project with Gradle Files」按钮

3. 检查并调整网络代理设置 #

如果你的开发环境使用了代理，可能代理失效或配置错误导致无法访问仓库：

• 打开AS的「File > Settings」，搜索「HTTP Proxy」
• 选择「No proxy」（如果不需要代理），或者确认代理的地址、端口、认证信息正确
• 同步项目后再尝试构建

4. 为特定依赖单独指定镜像仓库（临时应急方案） #

如果某些依赖暂时只能从jcenter获取，可以单独为该依赖指定镜像源，比如针对commons-codec:1.6：
在Module级build.gradle中添加：

repositories {
    maven { url 'https://maven.aliyun.com/repository/public' }
}

dependencies {
    implementation 'commons-codec:commons-codec:1.6'
}

这样Gradle会优先从指定镜像仓库拉取这个依赖，避开不稳定的jcenter。

一般来说，替换仓库为mavenCentral+国内镜像就能解决大部分问题，毕竟jcenter已经彻底退出历史舞台了，尽早替换能避免后续更多构建问题。

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