17370845950

firefox 中 `onauthstatechanged` 触发后立即读取 firestore 用户文档，可能因本地缓存未同步而返回空或过期数据；本文详解通过服务端读取、监听实时快照或检查元数据等方式可靠获取最新用户文档。

在 Firebase 应用中，常见模式是：用户登录后（如通过 signInWithPopup）立即调用 setDoc(..., { merge: true }) 初始化或更新其 Firestore 用户文档；与此同时，全局 onAuthStateChanged 监听器在认证状态变更时触发，并尝试读取该用户文档。但你观察到：即使 merge: true 仅写入空对象，后续 getDoc() 却返回空文档——而加 setTimeout(3000) 后却能正确读取完整数据。这并非“竞态条件”本身不可控，而是 Firestore SDK 默认优先从本地缓存读取，且此时缓存尚未反映刚刚完成的写入操作。

根本原因在于 Firestore 的离线写入与缓存同步机制：setDoc 在启用离线功能时会先写入本地缓存并异步同步至服务器，而 getDoc() 若未显式指定来源，默认可能返回 fromCache: true 的快照（尤其在写入刚发生、网络延迟或索引未就绪时）。可通过快照的 metadata 属性验证：

const docSnap = await getDoc(docRef);
console.log('From cache?', docSnap.metadata.fromCache);         // 可能为 true
console.log('Has pending writes?', docSnap.metadata.hasPendingWrites); // 可能为 true

✅ 推荐解决方案（按优先级排序）

1. 强制从服务器读取（最简单直接）
使用 GetOptions 指定 source: 'server'，跳过缓存，确保获取服务端最新状态：

export const initAuth = (): void => {
  auth.onAuthStateChanged(async (user) => {
    if (!user) return;

    try {
      const docRef = doc(getFirestore(), 'users', user.uid);
      // 关键：强制从服务器读取，忽略本地缓存
      const docSnap = await getDoc(docRef, { source: 'server' });

      if (docSnap.exists()) {
        console.log('✅ 最新用户数据:', docSnap.data());
      } else {
        console.log('⚠️ 用户文档尚不存在，需初始化');
        // 可在此处调用 signInAndUpdateUserObject 或直接创建
      }
    } catch (err) {
      console.error('❌ 读取用户文档失败:', err);
    }
  });
};

⚠️ 注意：source: 'server' 会增加网络延迟（无缓存），且在离线时抛出错误。若需离线支持，请结合方案2。

2. 使用实时监听器 + 元数据过滤（兼顾实时性与可靠性）
监听文档变化，等待 fromCache === false && hasPendingWrites === false 的稳定快照：

export const initAuth = (): void => {
  auth.onAuthStateChanged((user) => {
    if (!user) return;

    const docRef = doc(getFirestore(), 'users', user.uid);

    // 实时监听用户文档
    const unsubscribe = onSnapshot(docRef, (snapshot) => {
      const { fromCache, hasPendingWrites } = snapshot.metadata;

      // 等待非缓存、无未决写入的干净快照
      if (!fromCache && !hasPendingWrites) {
        console.log('✅ 已同步完成，获取到权威数据:', snapshot.data());
        unsubscribe(); // 读取成功后取消监听，避免内存泄漏
      }
      // 可选：添加超时保护（如 5s 后 fallback 到 server 读取）
    });
  });
};

3. 优化写入逻辑：避免冗余空写
当前 setDoc(doc, {}, { merge: true }) 实际不改变数据，却触发缓存更新。建议只在需要写入真实字段时执行（如 displayName, photoURL, createdAt），并考虑使用 updateDoc 替代 setDoc：

// 更安全的初始化写入（仅当字段缺失时）
await setDoc(
  doc(getFirestore(), 'users', user.uid),
  {
    displayName: user.displayName,
    photoURL: user.photoURL,
    email: user.email,
    createdAt: serverTimestamp(),
    lastLoginAt: serverTimestamp()
  },
  { merge: true }
);

? 总结

• ❌ 不要依赖 setTimeout 这类脆弱的时间猜测方案；
• ✅ 优先使用 { source: 'server' } 获取强一致性数据（适合登录后首次初始化场景）；
• ✅ 对高实时性要求场景，采用 onSnapshot + metadata 过滤，确保读取的是已同步至服务端的最终状态；
• ✅ 始终检查 snapshot.exists() 和 metadata，将缓存行为显式纳入程序逻辑，而非隐式假设。

通过以上任一方式，即可彻底规避 onAuthStateChanged 与用户文档写入之间的“幻读”问题，构建健壮的认证-数据同步流程。