使用Python将本地文件写入GCP时storage.Client初始化报错如何解决

OSError: Project was not passed and could not be determined from the environment. 报错的核心原因是storage.Client()初始化时既没有收到显式传入的GCP项目ID，也无法从运行环境的默认配置、环境变量、身份凭证中自动读取到有效的GCP项目ID，导致初始化流程中断。

全环境通用方案（优先推荐，兼容性最高） #

直接在初始化Client时显式传入GCP项目ID，本地环境还需同步传入服务账号密钥路径：

from gcloud import storage

# 替换为你实际的GCP项目ID
GCP_PROJECT_ID = "你的项目ID"
# 本地环境需配置服务账号密钥路径，Colab环境可省略该行
# SERVICE_ACCOUNT_KEY_PATH = "/本地路径/你的服务账号密钥.json"

# 本地环境使用以下初始化代码
client = storage.Client(project=GCP_PROJECT_ID, key_path=SERVICE_ACCOUNT_KEY_PATH)
# Colab环境使用以下初始化代码
# client = storage.Client(project=GCP_PROJECT_ID)

GCP项目ID可登录GCP控制台，在首页项目信息卡片中查询获取。

本地IDE免传参配置方案 #

如果不想每次初始化都显式传参，可提前配置本地GCP默认凭证：

• 安装GCP官方CLI工具gcloud
• 终端执行命令：gcloud auth application-default login
• 按照终端提示跳转浏览器登录你的GCP账号，完成默认凭证配置
• 配置完成后即可直接调用storage.Client()完成初始化，无需传参

Google Colab免传参配置方案 #

Colab环境可先执行身份授权命令，完成后即可自动读取项目信息：

from google.colab import auth
auth.authenticate_user()

运行单元格后按照提示跳转登录GCP账号完成授权，后续再调用storage.Client()即可正常初始化。

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