Mac系统gcloud安装运行异常与PATH配置问题求助

一、解决gcloud命令全局找不到问题 #

• 首先确认当前使用的shell类型，执行命令：
  echo $SHELL
  如果输出为/bin/zsh，后续操作针对~/.zshrc配置文件；如果输出为/bin/bash，针对~/.bash_profile配置文件。
• 打开对应配置文件，在末尾添加一行配置，将gcloud所在路径加入系统PATH：
  export PATH="$HOME/google-cloud-sdk/bin:$PATH"
  如果你的google-cloud-sdk文件夹没有放在当前用户根目录，需要把上面路径里的$HOME/google-cloud-sdk替换为你实际的安装路径
• 执行命令让配置立即生效：

# zsh用户执行
source ~/.zshrc
# bash用户执行
source ~/.bash_profile

配置完成后执行gcloud --version即可验证是否生效，无需再输入全路径调用。

二、解决Python上传GCS偶发失败问题 #

你看到的urllib3连接报错属于网络请求类异常，和gcloud SDK本身安装无关，之前重装后恢复属于巧合，刚好匹配了网络恢复的时间点，可通过以下方案彻底解决：

• 先打印完整报错堆栈，确认最终抛出的错误类型：是连接超时、SSL校验失败还是连接拒绝，不同错误对应不同处理逻辑
• 优先使用Google官方google-cloud-storagePython包实现上传逻辑，该包会自动处理身份认证、请求重试、异常兜底，比自行封装urllib3请求稳定性高很多
• 给上传逻辑增加指数退避重试机制：如果是偶发网络波动导致的失败，3-5次重试基本可以解决，官方SDK本身自带重试配置，也可以用tenacity等第三方库自定义重试规则
• 检查conda环境依赖兼容性：执行以下命令查看相关包版本

pip list | grep -E "urllib3|google-cloud-storage"

如果存在版本冲突，安装经过验证的兼容版本即可：
pip install urllib3==1.26.16 google-cloud-storage==2.10.0

• 如果本地配置了代理，将storage.googleapis.com加入代理直连名单，或者拉长请求超时参数，避免大文件上传时被代理主动断开连接。

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