更新Android Studio与Gradle后遇407代理认证错误求助

阿华AIGC实验室

2026-5-21

解决Android Studio & Gradle更新后407代理认证错误的方案

针对你遇到的更新AS和Gradle后出现Received status code 407 from server: Proxy Authentication Required的问题，我整理了几个亲测有效的解决方案，你可以逐个尝试：

配置Gradle全局代理（关键！）
Gradle的代理配置和Android Studio是相互独立的，哪怕AS的代理测试成功，Gradle本身可能没拿到正确的认证信息。你需要手动配置Gradle的全局代理：
1. 打开Windows用户目录（一般是C:\Users\你的用户名），找到.gradle文件夹（如果看不到，要开启显示隐藏文件）。
2. 在.gradle里新建或编辑gradle.properties文件，添加以下配置（替换成你的代理信息）：
```
systemProp.http.proxyHost=你的代理IP或域名
systemProp.http.proxyPort=代理端口号
systemProp.http.proxyUser=代理认证用户名
systemProp.http.proxyPassword=代理认证密码
systemProp.http.nonProxyHosts=localhost|127.0.0.1|*.yourcompany.com（按需添加不需要代理的地址）

systemProp.https.proxyHost=你的代理IP或域名
systemProp.https.proxyPort=代理端口号
systemProp.https.proxyUser=代理认证用户名
systemProp.https.proxyPassword=代理认证密码
systemProp.https.nonProxyHosts=localhost|127.0.0.1|*.yourcompany.com
```
3. 保存文件后，回到Android Studio点击Sync Project with Gradle Files按钮同步项目。
检查项目级Gradle配置
有些项目会在根目录的gradle.properties里单独配置代理，可能和全局配置冲突。打开项目根目录的gradle.properties，如果里面有类似systemProp.http.proxy*的配置，要么删除这些行，要么修改成和全局一致的内容，避免冲突。

替换为国内镜像仓库（绕过代理）
如果代理认证始终无法解决，且网络允许访问国内镜像，可以把google()、jcenter()替换为阿里云的maven镜像，直接下载依赖：
打开项目根目录的build.gradle，修改repositories部分：

buildscript {
    repositories {
        // 替换为阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        // 注释掉原来的仓库
        // google()
        // jcenter()
    }
    // 其他配置...
}

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

同步项目后，Gradle会从国内镜像下载依赖，无需走代理。

清理系统代理环境变量
检查Windows系统的环境变量是否存在冲突的代理配置：
1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
2. 在「用户变量」或「系统变量」里查找HTTP_PROXY、HTTPS_PROXY这两个变量。
3. 如果存在，要么确保变量值格式为http://用户名:密码@代理地址:端口，要么直接删除这两个变量，让Gradle使用自己的配置。
清除Gradle缓存
旧的缓存可能残留错误的代理信息，导致问题持续：
1. 关闭Android Studio。
2. 删除C:\Users\你的用户名\.gradle\caches整个文件夹。
3. 重新打开AS并同步项目，Gradle会重新下载所有依赖。