连接Firebase实时数据库报Unknown host代理错误如何解决

触发报错：Error: Unknown host 'No such host is known (proxy)'. You may need to adjust the proxy settings in Gradle

该报错核心原因是Gradle进程解析代理主机地址失败，无法建立到Firebase服务的网络连接，按以下步骤逐一排查即可修复：

• 优先排查全局Gradle配置错误：打开用户目录下的Gradle全局配置文件，Windows路径为C:\Users\你的用户名\.gradle\gradle.properties，macOS/Linux路径为~/.gradle/gradle.properties，检查所有带proxy前缀的配置项：
  *如果当前网络不需要走代理，直接删除所有systemProp.http.proxy*、systemProp.https.proxy*相关配置行
  *如果需要走代理，确认proxyHost没有填成proxy这类占位符字符串，必须填写实际可用的代理IP，本地代理默认配置参考如下：

  systemProp.http.proxyHost=127.0.0.1
  systemProp.http.proxyPort=你本地代理的实际端口
  systemProp.https.proxyHost=127.0.0.1
  systemProp.https.proxyPort=你本地代理的实际端口
  systemProp.http.nonProxyHosts=localhost|127.0.0.1|*.local
  

• 排查项目级Gradle配置冲突：打开当前Android项目根目录下的gradle.properties文件，重复上述代理配置检查逻辑，清除无效代理配置、修正错误的代理地址/端口值。90%以上的同类型报错都是因为配置里直接写了systemProp.https.proxyHost=proxy这类未替换占位符的无效配置。
• 排查IDE代理设置冲突：打开Android Studio设置页，找到Appearance & Behavior > System Settings > HTTP Proxy选项：
  *无代理环境直接选择No proxy
  *需要代理的场景准确填写代理地址和端口，点击Check connection测试连通性，确认可以正常访问外网后保存配置，重启IDE。
• 清理缓存重新同步：关闭IDE后在项目根目录执行对应命令清理Gradle构建缓存：

  # Windows系统
  gradlew cleanBuildCache
  # macOS/Linux系统
  ./gradlew cleanBuildCache
  

  执行完成后删除项目根目录下的.gradle缓存文件夹，重新打开项目触发Gradle同步即可。
• 内网环境额外检查：如果使用公司/团队统一代理，确认代理服务本身运行正常，且防火墙没有拦截Gradle进程的出站请求、没有封禁Firebase相关服务域名。

内容的提问来源于stack exchange，提问作者Luong Nguyen Viet Khoa K16_HL