网络错误导致Snapshot.exists()假阴性问题求助

核心思路是利用Firestore快照的metadata属性区分数据来源（缓存/服务器），避免因网络问题导致的误创建文档操作：

• snapshot.metadata.fromCache：返回true表示当前数据来自本地缓存，此时无法确定服务器上文档的真实状态；返回false表示数据直接来自Firebase服务器，状态可信。
• snapshot.metadata.hasPendingWrites：返回true表示当前快照包含未同步到服务器的本地写入操作，可辅助判断数据是否为最终状态。

修改后的代码实现 #

onSnapshot(this.userDocRef, {
  next: (snapshot) => {
    const isFromCache = snapshot.metadata.fromCache;

    if (snapshot.exists()) {
      const data = snapshotFactory(snapshot);
      console.log("data recieved from firestore: ", data);
      this.user.value = UserStore.firebaseUser
        ? userFactory(data, UserStore.firebaseUser)
        : null;
    } else {
      // 仅当数据来自服务器时，才确认文档不存在并执行创建
      if (!isFromCache) {
        console.log("document doesnt exist, creating one...");              
        let userData = {
          id: firebaseUser.uid,
          email: firebaseUser.email || "error:firebaseUser-no-email",
          displayName: firebaseUser.displayName || null,
          photoURL: firebaseUser.photoURL || null,
          emailVerified: firebaseUser.emailVerified,
          createdAt: new Date(),
        };
        setDoc(this.userDocRef!, userData);
      } else {
        console.log("当前数据来自缓存，暂无法确认文档状态，等待服务器同步...");
      }
    }
  },
  error: (err) => {
    console.error("快照监听异常:", err);
  }
});

逻辑说明 #

1. 当网络不佳时，监听器会优先返回本地缓存数据。若缓存中无对应文档，snapshot.exists()会返回false，但此时isFromCache为true，跳过文档创建逻辑。
2. 网络恢复后，Firestore自动同步服务器数据，监听器会再次触发，此时isFromCache为false。若exists()仍为false，即可确认服务器上文档确实不存在，执行创建操作。
3. 新增错误回调处理网络完全断开等异常场景，避免无意义的重试或创建操作。

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