调用download_to_filename在Google Cloud Storage生成空文件的解决办法

我之前也碰到过一模一样的问题——调用download_to_filename接口后，Google Cloud Storage里居然生成了空文件，排查了半天才发现是权限配置的坑。

问题根源 #

你大概率是只给实例关联的IAM角色授予了通用API所有权，但忽略了存储桶的存储策略需要单独配置所有权权限。这种权限不匹配会导致接口能成功创建文件，但没法写入实际内容，最终就生成了空文件。

解决办法 #

调整权限配置，重点是给存储策略授予对应的所有权权限，而不是只依赖IAM的通用权限配置。

参考代码示例 #

这里有一个标准的GCS下载Blob的Python实现示例，你可以参考这个逻辑来核对自己的代码：

def download_blob(bucket_name, source_blob_name, destination_file_name):
    """从存储桶下载Blob到本地文件"""
    storage_client = storage.Client()
    bucket = storage_client.get_bucket(bucket_name)
    # 获取目标Blob对象
    blob = bucket.blob(source_blob_name)
    # 执行下载到指定文件
    blob.download_to_filename(destination_file_name)

    print(f"Blob {source_blob_name} 已成功下载到本地路径 {destination_file_name}")

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