如何在Cloud Functions中提取Firestore文档列表字段内最新增改的数据项

方案1：直接取列表末尾元素（适合固定追加到末尾的场景） #

如果你的业务逻辑始终是往列表尾部追加新元素，不需要校验变更来源，直接读取更新后文档的列表最后一位即可：

export const grabId = functions.firestore
  .document('Posts/{documentId}')
  .onWrite(async (change,context) => {
    const afterData = change.after.exists ? change.after.data() : null;
    if(!afterData) return null;
    // 假设存储列表的字段名为 itemList，自行替换为你的实际字段名
    const targetList = afterData.itemList;
    if(!Array.isArray(targetList) || targetList.length === 0) return null;
    // 取列表最后一位即为最新追加的条目
    const latestItem = targetList[targetList.length - 1];
    // 后续处理latestItem的逻辑写在这里
    console.log('最新添加的条目：', latestItem);
    return null;
  })

方案2：对比前后文档差异，精准提取实际新增条目 #

如果要排除列表原有元素修改、删除、中间位置插入的干扰，准确识别本次变更新增的条目，需要对比事件触发前后的两份文档数据：

export const grabId = functions.firestore
  .document('Posts/{documentId}')
  .onWrite(async (change,context) => {
    const afterData = change.after.exists ? change.after.data() : null;
    const beforeData = change.before.exists ? change.before.data() : null;
    if(!afterData) return null;
    
    const afterList = afterData.itemList ?? [];
    const beforeList = beforeData?.itemList ?? [];
    // 如果是新文档创建，整个列表都是新增内容，直接取最后一位
    if(!beforeData) {
      const latestItem = afterList[afterList.length - 1] ?? null;
      console.log('新文档最新条目：', latestItem);
      return null;
    }
    // 列表元素是简单类型可直接对比，是对象的话建议用唯一标识（如id）对比
    // 示例假设元素带唯一id字段
    const beforeIdSet = new Set(beforeList.map(item => item.id));
    // 过滤出本次新增的所有条目
    const newAddedItems = afterList.filter(item => !beforeIdSet.has(item.id));
    // 取最新的一条（新增多条时取最后一条）
    const latestNewItem = newAddedItems[newAddedItems.length - 1] ?? null;
    console.log('本次新增的最新条目：', latestNewItem);
    return null;
  })

注意事项 #

• 如果列表元素为对象类型，不要直接做全等对比，建议用元素的唯一标识字段（如id、createTime）做差异校验
• 业务允许的情况下，建议给列表每个元素加createTime时间戳字段，直接按时间戳排序取最大值即可获得最新条目，不受插入位置的影响

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