使用gcloud部署Cloud Storage触发的Gen2 Cloud Function参数不匹配问题

问题场景 #

现有一段处理Firebase存储桶文件上传的Python Cloud Function代码：

@storage_fn.on_object_finalized(bucket = "my-bucket", timeout_sec = timeout_sec, memory = memory, cpu = cpu, region='us-central1')
def validate_file_upload(event: storage_fn.CloudEvent[storage_fn.StorageObjectData]):
    process(event)

使用Firebase CLI命令firebase deploy --only functions:validate_file_upload部署后，函数可正常触发执行；但改用gcloud命令部署Gen2版本时：

gcloud functions deploy validate_file_upload
--gen2 
--region=us-central1
--entry-point=validate_file_upload
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" 
--trigger-event-filters="bucket=my-bucket"

触发函数会抛出错误：

TypeError: validate_file_upload() takes 1 positional argument but 2 were given

问题根源 #

Firebase CLI部署时，默认以CloudEvent单参数模式触发函数，仅传递一个Eventarc对象；而直接用gcloud部署Gen2函数时，若未明确指定触发模式，会默认以旧版的双参数模式（data, context）传递参数，导致函数签名不匹配。

解决方法 #

方法一：改用Google Cloud官方的CloudEvent装饰器 #

替换Firebase的专属装饰器，使用Google Cloud Functions Framework的@cloud_event装饰器，确保函数在两种部署方式下都遵循CloudEvent单参数规范：

from functions_framework import cloud_event
from google.cloud.functions_v2 import storage_fn

@cloud_event
def validate_file_upload(event: storage_fn.CloudEvent[storage_fn.StorageObjectData]):
    process(event)

然后执行gcloud部署命令时，指定对应Python运行时版本（比如python311）：

gcloud functions deploy validate_file_upload \
--gen2 \
--region=us-central1 \
--runtime=python311 \
--entry-point=validate_file_upload \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=my-bucket"

方法二：修改函数签名兼容双参数模式 #

如果需要保留Firebase装饰器，可以调整函数签名，接受可选的第二个参数，统一处理两种触发模式的输入：

@storage_fn.on_object_finalized(bucket = "my-bucket", timeout_sec = timeout_sec, memory = memory, cpu = cpu, region='us-central1')
def validate_file_upload(event, context=None):
    # 区分触发模式，提取文件数据
    if context is not None:
        # gcloud双参数模式，event为存储对象数据
        file_event = event
    else:
        # Firebase CloudEvent模式，从event中提取数据
        file_event = event.data
    
    process(file_event)

内容的提问来源于stack exchange，提问作者the.Legend