部署Google Cloud Function时触发资源错误求助

我尝试用以下Gcloud CLI命令部署云函数，目标是当对象上传到GCS指定目录files/**/*.json时触发函数：

gcloud functions deploy function_name \
        --runtime python37 \
    --trigger-resource="gs://<bucket-name>/files/**/*.json" \
    --trigger-event=google.storage.object.finalize

但部署失败，报错：

ERROR: (gcloud.functions.deploy) wrong collection: expected [storage.objects], got [storage.buckets], for path [gs:///files/**/*.json]

尝试使用非官方支持的事件--trigger-event=google.storage.buckets.finalize时，又报错：

event_trigger.resource: GCS bucket resource gs:///files/**/*.json does not match the expected pattern, which is projects/{project}/buckets/{bucket}

已经做过这些操作：

• 尝试Gen2部署并使用对应触发事件名称（失败）
• 执行gcloud storage ls <wildcard_bucket path>验证路径能识别文件（成功）
• 确认拥有存储对象的读写删权限（成功）

错误原因 #

1. Cloud Functions Gen1的GCS触发器不支持通过--trigger-resource指定子目录或通配符，该参数只能接收完整的bucket路径（如gs://<bucket-name>），带路径的写法会被系统误判为bucket资源而非object资源，导致第一个错误。
2. google.storage.buckets.finalize是针对bucket本身创建/更新的事件，并非对象上传事件，且该事件要求资源必须是纯bucket格式，不能带子目录，因此第二个错误是事件类型与资源格式不匹配导致的。

解决方案 #

方案1：Gen1函数+代码内过滤 #

保持Gen1部署，触发器绑定整个bucket，在函数代码中判断对象路径是否符合要求：

修改后的部署命令

gcloud functions deploy function_name \
        --runtime python37 \
        --trigger-resource="gs://<bucket-name>" \
        --trigger-event=google.storage.object.finalize

Python代码过滤示例

def function_name(event, context):
    file = event
    file_path = file['name']
    # 校验路径是否以files/开头且以.json结尾
    if file_path.startswith('files/') and file_path.endswith('.json'):
        # 执行业务逻辑
        print(f"Processing target file: {file_path}")
    else:
        # 不符合条件则跳过
        print(f"Skipping non-target file: {file_path}")

方案2：Gen2函数+Eventarc过滤条件 #

Cloud Functions Gen2支持通过Eventarc设置事件过滤规则，直接指定对象的前缀和后缀，无需在代码中额外判断：

部署命令（替换占位符为实际值）

gcloud functions deploy function_name \
        --gen2 \
        --runtime python37 \
        --trigger-event="google.cloud.storage.object.v1.finalized" \
        --trigger-resource="projects/<your-project-id>/buckets/<bucket-name>" \
        --trigger-filters="name=files/**/*.json"

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