为何应用无法捕获Firestore所有文档的修改变更？

这个现象既不是应用响应不足，也不是你的操作有误，本质是Firestore实时快照的批量变更合并机制导致的，具体原因如下：

• Firestore会自动合并短时间内的批量变更
  你在全局队列循环调用20次runTransaction，这些更新操作的时间间隔极短，Firestore后端会把多个文档的变更合并成一个快照推送给客户端。这时候snapshot.documentChanges不会为每个修改的文档都标记.modified，但querySnapshot.documents会返回所有文档的最新状态——这是Firestore为了减少网络传输开销做的优化。

• 事务执行的微小延迟会导致变更分批推送
  即便用了全局队列，事务的实际执行可能因为网络波动、后端调度出现毫秒级延迟，部分变更会被分到后续的快照里推送，所以某次快照只能捕获部分.modified标记，但最终所有变更都会同步完成，不会丢失。

• 快速验证操作正确性的方式

  • 检查事务代码：确认每个事务里确实完成了3个字段的更新，没有因条件判断（比如字段值未变化）跳过更新的逻辑
  • 查看Firestore控制台的操作日志：直接确认20个文档的更新操作是否全部成功执行
  • 加日志排查：打印每次快照的documentChanges长度和documents长度，观察是否最终所有文档都能同步到最新状态

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