GCP配置Cloud Storage推送文件内容至Pub/Sub未获内容求助

1. 明确通知的核心限制 #

Cloud Storage通过Pub/Sub发送的通知仅包含文件元数据（如文件名、大小、创建时间、存储桶信息等），不会直接发送文件的实际内容。如果需要获取文件内容，必须：

• 从Pub/Sub消息中提取objectId和bucket字段
• 调用Cloud Storage工具或API（比如gsutil cat gs://<bucket>/<objectId>）拉取文件内容

2. 验证通知触发逻辑 #

执行gsutil notification create命令后，默认仅监听新上传/创建的文件，不会触发已有文件的通知。测试时需要重新上传目标文件，或修改文件触发更新事件。

3. 检查订阅配置正确性 #

• 确认订阅关联的是你创建的目标Topic，没有选错项目或Topic名称
• 查看订阅的消息保留时间，若消息生成后超过保留期未被拉取，会被自动删除
• 直接在控制台用命令拉取测试：

  gcloud pubsub subscriptions pull <你的订阅名称> --auto-ack
  

  检查是否能获取到文件元数据消息

4. 补全必要权限配置 #

• 确认执行gsutil notification create的账号拥有storage.buckets.update权限（创建通知的必备权限）
• 检查Cloud Storage的系统服务账号是否有Pub/Sub Topic的发布权限：
  1. 查看当前Topic的权限：

     gcloud pubsub topics get-iam-policy <你的Topic名称>
     

  2. 若缺少权限，添加绑定：

     gcloud pubsub topics add-iam-policy-binding <你的Topic名称> \
       --member="serviceAccount:service-<你的项目编号>@gcp-sa-pubsub.iam.gserviceaccount.com" \
       --role="roles/pubsub.publisher"
     

5. 核对通知配置详情 #

用命令查看已创建的通知配置，确认参数无误：

gsutil notification list gs://你的存储桶名称

确保topic指向目标Topic，format为JSON，eventTypes包含你需要的事件（默认是OBJECT_FINALIZE，即文件上传完成事件）

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