迁移至Android Studio 3.1.1后Gradle无法工作的问题求助

核心问题拆解 #

你遇到的这个情况挺典型：浏览器能顺利下载https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle/3.1.1/gradle-3.1.1.pom，但Gradle同步却抛出500内部服务器错误，而且已经配置了代理、开启了离线模式，还确认URL被代理拦截。这大概率是Gradle的代理配置和浏览器代理不匹配，或者代理对Gradle的请求做了特殊拦截处理导致的。

可能的原因及对应解决办法 #

• Gradle代理配置未生效或不完整
  浏览器的代理设置和Gradle的代理是完全独立的两套配置。哪怕你在Android Studio里设置了代理，Gradle可能还会读取系统环境变量或者gradle.properties里的旧配置。
  建议检查项目根目录和用户目录下的gradle.properties文件，确认代理配置是否正确（替换成你的实际代理信息）：

  systemProp.http.proxyHost=你的代理地址
  systemProp.http.proxyPort=代理端口
  systemProp.https.proxyHost=你的代理地址
  systemProp.https.proxyPort=代理端口
  # 如果代理需要账号密码认证
  systemProp.http.proxyUser=你的代理账号
  systemProp.http.proxyPassword=代理密码
  systemProp.https.proxyUser=你的代理账号
  systemProp.https.proxyPassword=代理密码
  

  同时在Android Studio的代理设置里，勾选**"Auto-detect proxy settings"或者手动填写正确代理，确保"Apply settings to all modules"**选项被选中。

• 代理对Gradle的请求头做了拦截/限制
  浏览器和Gradle发起请求的头部信息差异很大，比如Gradle的User-Agent是Gradle/3.1.1，而浏览器的是Chrome/xxx这类标识。有些代理服务器会针对特定客户端请求做限制，拒绝Gradle的请求后伪装成500错误返回。
  你可以尝试在gradle.properties里添加自定义User-Agent，模拟浏览器的请求头：

  systemProp.http.userAgent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36
  systemProp.https.userAgent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36
  

• 离线模式的冲突问题
  虽然你开启了离线模式，但如果本地Gradle缓存里没有gradle-3.1.1.pom这个文件，Gradle还是会尝试去远程仓库获取。这时候如果代理拦截请求但返回错误，就会触发500报错。可以先关闭离线模式，让Gradle正常下载依赖到本地缓存，之后再重新开启离线模式：
  操作路径：Android Studio → File → Settings → Build, Execution, Deployment → Build Tools → Gradle → 取消勾选**"Offline work"**，点击"Sync Now"。

• 代理SSL证书不被Gradle信任
  有些代理会替换HTTPS请求的SSL证书，如果Gradle不信任这个代理证书，可能会伪装成500错误返回。你可以把代理的根证书导入到JVM的信任存储里，或者临时配置Gradle忽略证书校验（不推荐生产环境使用）：
  在项目根目录的build.gradle里添加：

  allprojects {
      repositories {
          google()
          jcenter()
      }
  }
  // 临时忽略SSL校验（仅用于排查）
  tasks.withType(GradleBuild) {
      doFirst {
          System.setProperty("javax.net.ssl.trustStore", "你的代理证书路径.jks")
          System.setProperty("javax.net.ssl.trustStorePassword", "证书密码")
      }
  }
  

额外排查小技巧 #

1. 打开Android Studio的Gradle Console，查看更详细的错误日志，里面可能会有代理请求的具体细节，帮你精准定位问题。
2. 用curl命令模拟Gradle的请求，测试是否能正常获取POM文件：

   curl -x 你的代理地址:代理端口 -U 代理账号:密码 https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle/3.1.1/gradle-3.1.1.pom
   

   如果curl也返回500，说明代理确实对这类请求做了限制；如果curl能成功，那就是Gradle的配置出了问题。

内容的提问来源于stack exchange，提问作者Praveen Kumar Sugumaran