Firestore的onUpdate云函数触发时duration字段未正常更新问题

问题根因 #

你遇到的更新后duration字段不生效的问题，核心是以下3个代码错误：

• 未等待异步操作完成：set()是Firestore的异步写方法，返回Promise对象，你没有添加await关键字，云函数运行时会在写请求提交前直接终止进程，导致大部分场景下更新操作不会实际生效。
• 写操作目标错误：newData.parent!获取的是当前触发云函数的子文档所属的集合引用，不是文档引用，Firestore不支持直接往集合写入数据，这是更新完全不生效的核心原因。
• 写方法逻辑错误：set()默认会全量覆盖目标文档的所有字段，如果你统计文档中还存储了category分类计数等其他数据，直接调用set()会清空其余字段，你应该用update()方法或者给set()添加{merge: true}合并参数避免覆盖。
• 统计逻辑不符合预期：如果你要计算所有子文档的总时长，直接将当前子文档的WorkDuration赋值给统计字段的逻辑是错误的，更新场景下需要用原总时长减去旧的单条时长，再加上新的单条时长才能得到正确的总时长。

修正后的参考代码 #

export const updateDuration = 
functions.firestore.document('Duration/{userId}/Duration/{uid}')
.onUpdate(async(change, context) => {
  const oldData = change.before.data();
  const newData = change.after.data();
  const oldWorkDuration = oldData.WorkDuration || 0;
  const newWorkDuration = newData.WorkDuration || 0;

  // 时长未变化直接退出
  if (newWorkDuration === oldWorkDuration) {
    return null;
  }

  // 替换为你实际存储总数量、总时长的统计文档路径
  const statsDocRef = admin.firestore().doc(`Duration/${context.params.userId}/统计文档的ID`);

  // 原子操作更新总时长，避免并发更新冲突
  await statsDocRef.update({
    Duration: admin.firestore.FieldValue.increment(newWorkDuration - oldWorkDuration)
  });

  return null;
})

注意事项 #

• 如果你的统计文档还需要同步更新category的数量，可以在update方法的参数中添加对应字段的更新逻辑，配合increment实现计数的自动增减。
• 所有Firestore读写操作都必须添加await关键字等待操作完成，才能在云函数中正常执行，也方便你捕获异常排查问题。

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