Google Cloud SDK初始化时触发ConnectionError错误的排查与解决方法

这个错误本质上是DNS解析失败导致gcloud无法连接Google的OAuth2认证服务器，我来给你几个实用的排查和解决步骤：

• 检查域名解析是否正常
  先在命令行里运行nslookup oauth2.googleapis.com（Windows）或者dig oauth2.googleapis.com（Linux/macOS），如果返回“无法找到域名”之类的提示，说明你的本地DNS服务器无法解析这个地址，这是最常见的触发原因。

• 更换公共DNS服务器
  把你的网络DNS换成公共DNS，比如Google的8.8.8.8和8.8.4.4，或者Cloudflare的1.1.1.1：

  • Windows：打开「网络和共享中心」→ 更改适配器设置 → 右键当前网络 → 属性 → 双击「Internet协议版本4(TCP/IPv4)」→ 手动设置DNS地址
  • macOS：打开「系统偏好设置」→ 网络 → 选中当前网络 → 高级 → DNS → 添加新的DNS服务器
  • Linux：修改/etc/resolv.conf文件，添加nameserver 8.8.8.8；如果用systemd-resolved，需修改对应配置文件

• 配置代理（如果你的网络需要代理）
  如果是在公司或需代理的网络环境下，要给gcloud配置正确的代理参数：

  gcloud config set proxy/type http
  gcloud config set proxy/address 你的代理IP或域名
  gcloud config set proxy/port 代理端口
  

  如果代理需要账号密码认证，再添加：

  gcloud config set proxy/username 你的代理用户名
  gcloud config set proxy/password 你的代理密码
  

  配置完成后重新运行gcloud init试试。

• 临时关闭防火墙/安全软件
  本地防火墙、杀毒软件甚至VPN有时候会拦截gcloud的网络请求，先临时关闭这些软件，再尝试登录。如果关闭后能成功，记得在安全软件里添加gcloud的网络访问权限。

• 重置gcloud的网络配置
  如果之前误配置了代理或其他网络参数，可以重置相关配置：

  gcloud config unset proxy/type
  gcloud config unset proxy/address
  gcloud config unset proxy/port
  gcloud config unset proxy/username
  gcloud config unset proxy/password
  

  之后重新运行gcloud init。

• 检查hosts文件是否有错误条目
  打开本地hosts文件，看看有没有错误的oauth2.googleapis.com映射：

  • Windows路径：C:\Windows\System32\drivers\etc\hosts
  • macOS/Linux路径：/etc/hosts
    如果有相关条目，直接删除，保存后再尝试解析域名。

内容的提问来源于stack exchange，提问作者Koustubh Kulkarni