Firestore getDoc仅返回单个字段问题排查（React环境）

核心问题分析 #

生产环境下调用getDocFromServer仅返回lastLogin字段，本地/开发环境正常，注释更新lastLogin的代码后生产环境恢复正常，说明问题与setDoc的更新操作强相关。

1. 代码拼写错误（优先修复） #

观察认证阶段的代码，存在变量名大小写错误：

// 错误写法：userdata 应为 userData
userdata.dateJoined = todayMMDDYYY; 

这个低级错误会导致新用户创建时无法添加dateJoined字段，虽然不直接影响已有用户的字段读取，但可能在生产环境的异常触发链中引发意外行为，需立即修正为：

userData.dateJoined = todayMMDDYYY;

2. Firestore安全规则限制 #

检查生产环境的Firestore安全规则，确认是否存在字段级读取限制。例如错误的规则可能仅允许读取lastLogin字段：

// 错误示例：限制了读取字段
match /users/{userId} {
  allow read: if request.auth != null && request.auth.uid == userId 
              && request.resource.data.keys().hasOnly(["lastLogin"]);
}

正确的规则应允许用户读取自己的完整文档：

match /users/{userId} {
  allow read, write: if request.auth != null && request.auth.uid == userId;
}

3. 并发写入导致的覆盖问题 #

onAuthStateChanged可能因用户刷新页面、Token刷新等场景多次触发，多次执行setDoc时，若生产环境网络延迟导致并发操作，可能出现merge选项未正常生效的情况。改用事务确保原子性操作：

onAuthStateChanged(auth, async (user) => {
  if (!user) return;
  const userRef = doc(db, 'users', user.uid);
  try {
    await runTransaction(db, async (transaction) => {
      const docSnapshot = await transaction.get(userRef);
      const userData = { lastLogin: todayMMDDYYY };
      if (!docSnapshot.exists()) {
        userData.dateJoined = todayMMDDYYY;
      }
      transaction.set(userRef, userData, { merge: true });
    });
  } catch (e) {
    console.error("更新用户登录时间失败: ", e);
  }
});

4. 生产环境数据完整性验证 #

直接登录Firestore生产控制台，查看受影响用户的文档内容：

• 如果文档仅包含lastLogin字段：说明写入操作意外覆盖了原有数据，需排查是否有其他代码（如生产环境专属逻辑）在修改用户文档
• 如果文档包含完整字段但查询仅返回lastLogin：重点排查getDocFromServer的调用逻辑，或Firestore SDK在生产环境的版本兼容问题

5. 排查其他潜在覆盖逻辑 #

检查生产环境是否存在其他写入用户文档的代码（如游戏数据更新、用户信息修改），确认这些操作是否使用了merge: true选项，避免因全量写入覆盖原有字段。

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