Firebase扩展中二代Firestore Cloud Function事件读取异常求助

数据老陈

2026-7-11

解决Firebase扩展GCFv2 Firestore触发器event.data为空/ docId未定义的问题

1. 修正extension.yaml的触发器配置

GCFv2的Firestore触发器在扩展里有几个必须注意的配置点：

明确指定platform: gcfv2
eventTrigger的resource路径要包含占位符（比如{docId}），这是后续获取文档ID的关键
必须添加扩展专属的labels字段

正确的yaml配置片段参考：

resources:
  - name: onDocCreated
    type: firebaseextensions.v1beta.function
    properties:
      platform: gcfv2
      runtime: nodejs18 # 替换为你使用的Node.js版本
      eventTrigger:
        eventType: google.cloud.firestore.document.v1.created
        resource: projects/${param:PROJECT_ID}/databases/(default)/documents/docs/{docId}
        serviceAccountEmail: ${param:EXTENSION_SERVICE_ACCOUNT_EMAIL}
      labels:
        firebase.googleapis.com/extension: true

2. 适配GCFv2的事件结构编写代码

GCFv2和旧版的事件格式完全不同，别再用v1的写法：

从firebase-functions/v2/firestore导入onDocumentCreated
文档ID从event.params.docId获取（这里的docId要和yaml路径里的占位符名称一致）
文档数据通过event.data.data()获取，event.data是完整的DocumentSnapshot对象

正确的代码示例：

const { onDocumentCreated } = require("firebase-functions/v2/firestore");

exports.onDocCreated = onDocumentCreated("docs/{docId}", (event) => {
  const docId = event.params.docId;
  const docData = event.data.data();

  if (!docData) {
    console.log("文档数据为空");
    return;
  }

  console.log(`处理文档 ${docId}:`, docData);
  // 在这里编写你的业务逻辑
});