Android Studio配置No Proxy后无法联网

Question

在使用Android Studio时，部分开发者在配置网络代理为“No Proxy”后仍遭遇无法联网的问题，表现为Gradle同步失败、依赖库下载超时等。常见原因包括：系统环境变量或gradle.properties中残留代理配置、Android Studio缓存异常、防火墙限制或DNS解析问题。即便界面设置为“No Proxy”，旧的代理配置可能仍生效。建议检查项目及全局gradle.properties文件，清除无效代理参数，并重启Android Studio；同时验证系统网络连通性，确保未被企业网络策略拦截。

Answer 1

1. 问题背景与现象描述

在使用 Android Studio 进行开发时，部分开发者即使将网络代理设置为“No Proxy”，仍然遇到无法联网的问题。典型表现为：Gradle 同步失败、依赖库下载超时、远程仓库（如 Maven Central、Google Maven）无法访问等。

尽管 IDE 界面显示已禁用代理，但底层构建系统（Gradle）可能仍在使用先前配置的代理信息，导致网络请求被错误路由或阻断。这种“表面无代理，实际仍代理”的情况常让开发者陷入排查困境。

2. 常见原因分类与层级分析

从技术栈角度出发，该问题可划分为多个层级，按由浅入深顺序如下：

1. 应用层配置残留：Android Studio UI 设置未覆盖所有配置源。
2. 构建系统级代理：Gradle 的 properties 文件中存在硬编码代理参数。
3. 操作系统环境变量：系统级 HTTP_PROXY/HTTPS_PROXY 影响 JVM 进程。
4. JVM 启动参数：studio64.exe.vmoptions 或 gradle.properties 中传递了代理。
5. 本地缓存与状态异常：Android Studio 缓存或 Gradle daemon 持有旧连接上下文。
6. 网络基础设施限制：企业防火墙、DNS 解析策略、透明代理拦截。

3. 核心排查路径与解决方案

排查层级	检查项	解决方式
IDE 设置	File → Settings → Appearance & Behavior → System Settings → HTTP Proxy	确认为 "No proxy"，并点击 Apply + OK
全局 Gradle 配置	~/.gradle/gradle.properties	删除或注释掉 systemProp.http.proxyHost 等相关行
项目级 Gradle 配置	project-root/gradle.properties	同上处理，避免局部覆盖全局设置
环境变量	Shell 或 Windows 环境变量中是否存在 HTTP_PROXY	unset HTTP_PROXY HTTPS_PROXY（Linux/macOS）；Windows 删除对应变量
JVM 参数	idea.properties 或 studio64.exe.vmoptions	检查是否通过 -D 参数强制指定代理

4. 清理缓存与重启策略

即便清除配置，Gradle Daemon 和 Android Studio 自身缓存可能导致设置不生效。建议执行以下命令：

# 终止所有 Gradle 守护进程
./gradlew --stop

# 清理项目构建缓存
./gradlew cleanBuildCache

# 删除本地 Gradle 缓存目录（谨慎操作）
rm -rf ~/.gradle/caches/

# 在 Android Studio 中执行：
# File → Invalidate Caches / Restart → Invalidate and Restart

5. 网络连通性验证流程图

graph TD A[开始排查] --> B{Android Studio 代理设为 No Proxy?} B -->|是| C[检查 gradle.properties] B -->|否| D[设置为 No Proxy] D --> C C --> E{存在 systemProp.proxy*?} E -->|是| F[删除或注释代理配置] E -->|否| G[检查系统环境变量] F --> G G --> H{存在 HTTP_PROXY?} H -->|是| I[清除环境变量] H -->|否| J[测试网络连通性] I --> J J --> K{能否访问 repo.maven.apache.org?} K -->|否| L[检查 DNS / 防火墙 / 企业策略] K -->|是| M[重新同步 Gradle] L --> M M --> N[问题解决]

6. 企业网络环境下的特殊考量

在大型组织中，即便本地未配置代理，也可能存在：

• 透明代理：网络流量被自动重定向至内部代理服务器，无需客户端显式配置。
• PAC 脚本策略：通过 DHCP 分发代理自动配置脚本，影响 JVM 网络行为。
• DNS 污染或劫持：对 dl.google.com 或 jcenter.io 返回错误 IP。
• MTU 不匹配或 TLS inspection：中间设备修改 SSL 流量导致握手失败。

此时需配合 IT 部门确认出口策略，并考虑使用 -Djdk.internal.http.disableHttp2=true 或更换镜像源（如阿里云 Maven）规避问题。