调用setDoc后Firestore快照缺失字段问题求助

以下是几个可能的原因及对应的排查、解决步骤：

1. 检查getTasks是否使用了投影查询 #

如果你的getTasks函数中用了select()方法明确指定只获取name和email字段，那么返回的快照自然不会包含tasks。比如：

// 错误示例：限制了查询字段
const docRef = db.collection('users').doc(userId);
const docSnap = await docRef.select('name', 'email').get();

解决办法：
去掉select()方法以获取文档所有字段，或者将tasks加入查询字段列表：

// 方式1：获取全部字段
const docSnap = await docRef.get();

// 方式2：明确指定包含tasks
const docSnap = await docRef.select('name', 'email', 'tasks').get();

2. 排查客户端缓存问题 #

Firestore客户端默认优先读取本地缓存数据，如果updateDoc刚完成缓存未同步，就会出现控制台有数据但快照返回旧内容的情况。可以强制从服务器读取最新数据：

const docSnap = await docRef.get({ source: 'server' });

3. 确认文档引用的ID一致性 #

检查登录时创建文档使用的ID，与getTasks中查询文档的ID是否完全一致。比如登录时用auth.currentUser.uid创建文档，但getTasks中误用了其他ID：

// 登录时创建文档（正确）
const userDocRef = db.collection('users').doc(auth.currentUser.uid);
await setDoc(userDocRef, { name, email });

// 错误示例：getTasks使用了错误的文档ID
const getTasks = async () => {
  const wrongDocRef = db.collection('users').doc('invalid-user-id');
  const docSnap = await wrongDocRef.get();
  // ...
};

解决办法：确保所有操作都使用同一个用户ID（通常是当前认证用户的uid）来引用文档。

4. 检查Firestore安全规则 #

如果安全规则限制了可读取的字段，比如只允许读取name和email，那么即使文档存在tasks字段，客户端也无法获取到：

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

解决办法：调整安全规则，允许读取所有字段或明确包含tasks：

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

5. 验证updateDoc操作是否成功 #

虽然控制台显示有tasks字段，但可以给updateDoc添加错误处理，确认代码中的任务添加操作确实成功执行：

const addTask = async (task) => {
  const userDocRef = db.collection('users').doc(auth.currentUser.uid);
  try {
    await updateDoc(userDocRef, {
      tasks: arrayUnion(task)
    });
    console.log('任务添加成功');
  } catch (error) {
    console.error('添加任务失败:', error);
  }
};

如果之前的updateDoc存在报错，可能控制台的tasks是通过其他方式写入的，而代码中的更新并未生效。

内容的提问来源于stack exchange，提问作者Tamer Yeşildağ