使用Python SDK向Cloud Storage上传文件如何获取操作响应结果

问题原因 #

Google Cloud Storage Python SDK 中的 upload_from_string() 方法原生设计就没有返回值，操作成功时返回 None 是正常表现，只有当操作出现错误时会抛出对应异常。

解决方案 #

以下是三种常用的验证上传结果、获取响应信息的方式：

• 方式1：通过异常捕获判断上传结果
  这是官方推荐的最简判断方式，只要方法执行过程中没有抛出异常，就代表上传成功。你可以捕获常见的GCS操作异常做分支处理：

from google.cloud import storage
from google.api_core.exceptions import GoogleAPIError, ClientError, ServiceUnavailable

bucket = storage.Client().get_bucket('mybucket')
df = # 待保存的pandas df
csv = df.to_csv(index=False)
output = 'test.csv'
blob = bucket.blob(output)

try:
    blob.upload_from_string(csv)
    # 执行到此处即代表上传成功
    print(f"文件{output}上传成功")
except (GoogleAPIError, ClientError, ServiceUnavailable) as e:
    # 捕获异常代表上传失败，变量e中包含详细错误信息
    print(f"文件上传失败，错误信息：{str(e)}")

• 方式2：上传后拉取Blob元数据验证+获取详情
  如果需要获取上传后文件的具体信息（比如文件大小、MD5校验值、ETag等）做进一步校验，可以在上传完成后调用blob.reload()拉取云端最新的元数据，能正常拉取就代表文件确实上传成功：

# 接上述上传代码，无异常抛出后执行
blob.reload() # 拉取云端最新的Blob信息
# 可以获取各类信息用于日志记录或校验
file_info = {
    "file_name": output,
    "size": blob.size,
    "md5": blob.md5_hash,
    "etag": blob.etag,
    "upload_time": blob.updated
}
print(f"上传成功，文件详情：{file_info}")

如果本地有提前计算好的CSV文件MD5，还可以和blob.md5_hash做对比，避免传输过程中出现数据损坏。

• 方式3：调用底层方法获取原始响应（不推荐）
  如果你确实需要拿到HTTP级别的原始响应，可以调用SDK底层的_do_upload方法，但该方法属于内部非公开API，可能随版本更新发生变动，不推荐生产环境使用：

# 仅作为参考，生产环境优先使用前两种方案
response = blob._do_upload(
    content_type="text/csv",
    data=csv,
    client=blob.client,
)
# response中包含原始HTTP响应信息

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