You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio 3.1更新后Gradle同步失败,报502 Bad Gateway错误

解决Gradle同步失败(502 Bad Gateway)问题

这种升级Android Studio和Gradle后碰到的502错误我之前也踩过坑,大概率是网络访问不稳定或者仓库源的问题,给你几个实测有效的解决办法:

1. 替换为国内Maven镜像源

jcenter在国内访问经常抽风,换成阿里云这类国内镜像基本能解决问题。修改项目根目录的build.gradle文件,把原有的仓库配置替换成国内镜像:

buildscript {
    repositories {
        // 优先用国内镜像
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google() // Google仓库还是要保留
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.0' // 对应你的Gradle版本
    }
}

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

修改完点击右上角的Sync Now,或者重启Android Studio再同步。

2. 检查并关闭HTTP代理

有时候Android Studio的代理配置残留会导致请求异常:

  • 打开File > Settings > Appearance & Behavior > System Settings > HTTP Proxy
  • 选择No proxy选项,点击Apply后重启AS,再尝试同步。

3. 清理Gradle本地缓存

缓存文件损坏也可能引发这类问题,手动清理缓存后重新下载依赖:

  • 找到Gradle缓存目录:Windows下是C:\Users\<你的用户名>\.gradle\caches,Mac/Linux是~/.gradle/caches
  • 删除目录下的modules-2文件夹(这个是存储依赖缓存的核心目录)
  • 回到AS重新执行Gradle同步。

4. 临时启用离线模式(应急用)

如果着急开发,可先开启离线模式使用本地已有的依赖:

  • 打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle
  • 勾选Offline work选项,同步项目。注意:这个方法只能临时用,后续还是要解决网络/镜像问题来更新新依赖。

补充说明

502 Bad Gateway是网关错误,本质是你的请求无法正常到达jcenter服务器,或者服务器返回的响应被中间节点拦截了。国内环境下,替换稳定的国内镜像源是最彻底的解决方式。

内容的提问来源于stack exchange,提问作者Mikhail

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.21 04:20:41