Firebase Cloud Function触发正常却抛出「资源字符串格式不匹配」错误

直接修复方案 #

修改GitHub Actions部署配置中的event_trigger_resource字段，将数据库名称替换为(default)：

event_trigger_resource: "projects/my-project-id/databases/(default)/documents/items/{itemId}"

错误原因解析 #

报错来自@google-cloud/functions-framework的资源解析逻辑，Firestore事件的资源路径有严格格式要求：

• 默认数据库的路径必须使用(default)作为数据库标识，而非控制台显示的自定义名称
• 当你填写my-firestore-name时，中间件无法正确解析资源结构，导致抛出格式不匹配错误
• 函数仍能触发是因为事件投递本身成功，但中间件在转换事件格式时失败，不影响事件触发流程，但会产生错误日志

额外调试与验证步骤 #

• 若确实使用非默认Firestore数据库，需通过GCP CLI命令gcloud firestore databases list获取数据库的资源名称，而非控制台显示的友好名称，填入路径中
• 检查@google-cloud/functions-framework版本，低版本可能不支持非默认数据库的路径解析，建议升级到最新稳定版
• 本地调试：使用functions-framework工具模拟Firestore触发事件，传入符合格式的资源路径，验证解析逻辑是否正常

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