Firestore JS SDK的HTTP网络请求流程是什么？附异常场景问询

我们在业务中大量使用Firebase JS SDK，曾碰到两个棘手问题：一是通过updateDoc发起的更新未同步到服务器（无任何网络异常提示）；二是onSnapshot监听无法获取服务器已存在的更新。为排查根因，我们梳理了这两个API调用时的HTTP请求网络层流程，以及如何在Chrome DevTools中对应到具体SDK调用，现将发现整理如下，同时期待Firebase官方团队的确认：

一、updateDoc 对应的网络请求流程 #

• 调用updateDoc后，SDK优先更新本地文档缓存（离线模式下仅完成此步）
• 在线状态下，SDK会发起POST请求到https://firestore.googleapis.com/v1/projects/{项目ID}/databases/(default)/documents:commit
  • 请求体包含writes数组，明确标记更新的文档路径、字段变更内容
  • 在Chrome DevTools中，可通过请求URL的commit关键词、请求体里的update操作类型，关联到对应的updateDoc调用
• 请求成功返回200后，服务器同步更新文档，SDK再将确认后的状态同步回本地缓存；若请求无响应或失败，SDK会自动触发重试（需关注重试策略的触发条件）

二、onSnapshot 对应的网络请求流程 #

• 首次调用onSnapshot时，SDK发起POST请求到https://firestore.googleapis.com/v1/projects/{项目ID}/databases/(default)/documents:listen
  • 请求体包含addTarget指令，指定监听的文档/集合路径，以此建立长连接监听变更
  • 该请求会长期处于"pending"状态，直到主动取消监听或连接中断
• 当服务器端文档发生变更时，会通过此长连接返回包含documentChange的响应，SDK据此更新本地缓存并触发监听回调
• 若出现监听失效但服务器已有更新的情况，可从DevTools中排查：
  • 该listen请求是否已断开（状态变为canceled或failed）
  • 请求体中的resumeToken是否正常携带（用于断线后恢复监听，丢失可能导致无法获取历史变更）

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