Firebase Cloud Functions的onUpdate触发器如何获取仅更新字段而非全量数据？

嘿，我懂你的困扰——默认情况下，Firestore的onUpdate触发器确实只会返回文档更新前后的完整快照，没办法直接拿到仅被修改的字段。不过我们可以自己写个简单的对比逻辑，从前后快照里提取出真正变化的内容。

基础实现：对比顶层字段 #

首先，你可以写一个辅助函数，遍历after数据里的字段，和before的数据对比，找出值不一样的字段，同时还要注意那些被删除的字段（也就是before里有但after里没有的）：

function getUpdatedFields(beforeData, afterData) {
  const updatedFields = {};

  // 检查新增或修改的字段
  Object.keys(afterData).forEach(field => {
    if (!beforeData || beforeData[field] !== afterData[field]) {
      updatedFields[field] = afterData[field];
    }
  });

  // 检查被删除的字段
  if (beforeData) {
    Object.keys(beforeData).forEach(field => {
      if (!afterData.hasOwnProperty(field)) {
        updatedFields[field] = null; // 用null标记字段被删除
      }
    });
  }

  return updatedFields;
}

然后把这个函数集成到你的云函数里：

exports.updateEntry = functions.firestore
  .document('/customer1/{docID}')
  .onUpdate((change: any, context: any) => {
    const id = context.params.docID;
    console.log("文档ID: " + id);
    
    const beforeData = change.before.data();
    const afterData = change.after.data();
    
    const updatedFields = getUpdatedFields(beforeData, afterData);
    console.log("仅更新的字段: ", JSON.stringify(updatedFields));
    
    // 这里可以添加你后续的业务逻辑，比如处理这些更新的字段
    return null;
  });

进阶：处理嵌套对象 #

如果你的文档里有嵌套对象，上面的基础方法只会对比顶层字段。如果需要深入嵌套对象找出具体修改的子字段，可以用递归版本的对比函数：

function getDeepUpdatedFields(beforeData, afterData, path = '') {
  const updatedFields = {};

  // 处理新增或修改的字段（包括嵌套对象）
  Object.keys(afterData).forEach(field => {
    const currentPath = path ? `${path}.${field}` : field;
    const beforeValue = beforeData ? beforeData[field] : undefined;
    const afterValue = afterData[field];

    if (typeof afterValue === 'object' && afterValue !== null && !Array.isArray(afterValue)) {
      // 递归处理嵌套对象
      const nestedUpdates = getDeepUpdatedFields(beforeValue, afterValue, currentPath);
      Object.assign(updatedFields, nestedUpdates);
    } else if (beforeValue !== afterValue) {
      updatedFields[currentPath] = afterValue;
    }
  });

  // 处理被删除的字段（包括嵌套对象里的）
  if (beforeData) {
    Object.keys(beforeData).forEach(field => {
      const currentPath = path ? `${path}.${field}` : field;
      if (!afterData.hasOwnProperty(field)) {
        updatedFields[currentPath] = null;
      } else {
        const beforeValue = beforeData[field];
        const afterValue = afterData[field];
        if (typeof beforeValue === 'object' && beforeValue !== null && !Array.isArray(beforeValue)) {
          // 递归检查嵌套对象里的删除字段
          const nestedDeletes = getDeepUpdatedFields(beforeValue, afterValue, currentPath);
          Object.assign(updatedFields, nestedDeletes);
        }
      }
    });
  }

  return updatedFields;
}

使用这个递归函数的话，就能精准定位到嵌套对象里被修改的具体子字段了。

注意事项 #

• 这个方法依赖于JavaScript的严格相等（===），如果你的字段值是复杂类型（比如Date对象），可能需要额外处理，把它们转换成可对比的格式（比如ISO字符串）。
• 如果文档里有数组，上面的递归方法会把整个数组当成一个字段对比，如果需要找出数组里的具体变化，还得再针对性地写逻辑。

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