由Firestore触发的Cloud Function部署后监听路径异常变更问题

1. Cloud Console前端表单Bug：部分可用区的Google Cloud控制台前端存在未修复的表单序列化问题，当你输入包含多段通配符的Firestore触发路径时，前端提交请求会自动截断通配符前的所有父级路径，仅保留最后一段通配符内容。
2. 多部署源配置冲突：如果你此前使用过gcloud CLI、Firebase CLI部署过同名称的函数，本地配置文件（如firebase.json、函数部署配置文件）中写死的触发器路径优先级高于控制台输入的配置，会自动覆盖控制台的路径设置。
3. 权限不足导致配置回滚：当前部署账号缺少cloudfunctions.functions.update、datastore.indexes.create等必要权限时，Firestore路径的层级校验会失败，后台会自动回退到最简的单段通配符路径避免部署报错。

• 优先改用CLI部署避开控制台Bug：不用Cloud Console网页端部署，直接通过gcloud CLI指定完整触发路径部署，示例命令如下，替换其中的占位符即可使用：

gcloud functions deploy 你的函数名称 \
--runtime python311 \
--trigger-event providers/cloud.firestore/eventTypes/document.create \
--trigger-resource "projects/你的GCP项目ID/databases/(default)/documents/users/{userID}/contactDump/{dumpID}"

• 清理多端部署冲突配置：如果你使用过Firebase CLI部署过函数，检查本地firebase.json文件以及Python函数代码中的触发器装饰器配置，删除写死的错误触发路径后再重新部署。
• 校验部署账号权限：确认当前使用的部署账号拥有Cloud Function管理员、Firestore管理员角色，或单独授予cloudfunctions.functions.update、datastore.indexes.list、datastore.indexes.create权限，避免权限不足导致配置被后台自动回滚。
• 确认最终生效路径：部署完成后不要直接查看触发器编辑页的内容，进入Cloud Function详情页的「触发器」标签卡查看最终生效的路径，编辑页偶尔会存在前端渲染延迟问题，实际生效路径以详情页展示内容为准。

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