订阅Firestore单个文档时，如何获取DocumentChange对象？

当你监听单个文档时，Firestore不会像集合监听那样直接返回DocumentChange，但可以通过维护前一次的快照状态来判断当前文档的变更类型，具体实现思路如下：

核心逻辑 #

通过保存上一次获取的DocumentSnapshot，对比当前快照的状态（是否存在、数据是否变化），来推断变更类型：

• 当前快照存在，且无历史快照 → 创建（added）
• 当前快照存在，且历史快照数据与当前不一致 → 修改（modified）
• 当前快照不存在，但历史快照存在 → 删除（removed）

代码示例（JavaScript） #

// 初始化历史快照变量
let previousSnapshot = null;

// 监听目标文档
db.collection("target-collection").doc("target-doc-id").onSnapshot((currentSnapshot) => {
  let changeType = null;

  if (currentSnapshot.exists) {
    if (!previousSnapshot) {
      // 首次获取到文档，判定为创建
      changeType = "added";
    } else if (JSON.stringify(currentSnapshot.data()) !== JSON.stringify(previousSnapshot.data())) {
      // 数据发生变更，判定为修改
      changeType = "modified";
    }
  } else {
    if (previousSnapshot?.exists) {
      // 文档从存在变为不存在，判定为删除
      changeType = "removed";
    }
  }

  // 根据变更类型执行对应逻辑
  if (changeType) {
    console.log(`文档变更类型：${changeType}`);
    // 这里可以加入业务处理代码，比如更新UI、同步数据等
  }

  // 更新历史快照为当前快照
  previousSnapshot = currentSnapshot;
}, (error) => {
  console.error("监听出错：", error);
});

注意事项 #

• 用JSON.stringify对比数据是简易方案，若文档包含Timestamp、GeoPoint等复杂类型，需要自定义对比逻辑，避免误判。
• 监听断开重连后，previousSnapshot会重置为null，此时首次收到的快照会被判定为added，这符合Firestore重连时发送最新状态的行为。
• 若文档初始不存在，首次监听会返回不存在的快照，但因无历史快照，不会触发变更类型判定，只有当文档从无到有时才会标记为added。

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