如何限制同一时间仅一个onUpdate函数访问Firestore指定文档？

方案1：使用Firestore原子增量操作（优先级最高） #

Firestore内置了原子数值操作接口FieldValue.increment()，不需要先读取文档再计算写入，所有累加操作直接在数据库层面原子执行，天然规避并发读写冲突，就算同时触发上百次更新也不会出现计算错误，适配你当前的数值累加场景。

• 新增销售记录时传入正数：admin.firestore.FieldValue.increment(100) 表示给对应字段加100
• 删除销售记录时传入负数：admin.firestore.FieldValue.increment(-100) 表示给对应字段减100
• 支持同一次更新操作中对多个字段分别执行原子操作，完全满足你多字段计算更新的需求。

方案2：使用Firestore事务处理 #

如果你的统计字段计算逻辑比较复杂，不是单纯的数值加减（比如需要结合其他字段做阈值判断、比例计算等），可以用Firestore自带的事务机制实现并发控制：

• 事务会自动检测你读取的Actuals文档在写入前是否被其他请求修改，如果检测到变更会自动重试（默认最多重试5次），保证最终写入的计算结果正确。
• 参考代码示例：

const actualsRef = admin.firestore().doc(`${actualsCollectionName}/${actual.id}`);
await admin.firestore().runTransaction(async (transaction) => {
  const actualsDoc = await transaction.get(actualsRef);
  const currentData = actualsDoc.data() as ActualsDto;
  // 执行你的所有复杂计算逻辑
  const calculatedData = service.calculateActuals(currentData, change.after.data());
  transaction.update(actualsRef, calculatedData);
});

方案3：通过云任务队列串行执行更新 #

如果单次离线同步产生的并发更新量特别大（超过事务重试上限），可以将更新逻辑抽为云任务，给同一个用户的Actuals文档更新任务设置串行执行规则，同一时间只处理1个对应文档的更新请求，从根源上避免并发冲突。

你提到的强制等待文档无占用、延迟同步等需求不需要自行实现，上述Firebase原生提供的机制已经可以稳定解决你的并发问题，且性能和可靠性远高于自定义锁、延迟策略。

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