Firestore查询匹配UID用户数据失败，返回undefined

可能的原因及解决方法 #

1. UID字段不匹配 #

• 先确认Firestore的users集合中，每个文档的uid字段值，和登录后控制台输出的user.uid完全一致（Firestore字符串大小写敏感，注意不要有空格、大小写差异）。
• 检查创建用户时的代码，确保是把登录成功后返回的user.uid写入到users文档的uid字段，而非误用文档ID或其他标识。

2. Firestore安全规则限制 #

默认安全规则会禁止未授权访问，登录用户可能没有权限读取users集合数据。可以修改为仅允许用户读取自身数据的规则（开发测试时可用）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == resource.data.uid;
    }
  }
}

3. 代码未正确处理查询结果 #

你的代码使用onSnapshot实时监听，但如果查询无结果，users数组为空，直接取值会返回undefined。可以修改代码添加空值判断，并优化数据提取逻辑：

signInWithEmailAndPassword(auth, email, password)
  .then(userCred => {
    setErrorMessage(null);
    const user = userCred.user;
    console.log(user.uid);

    // User Role check
    const userRef = collection(db, 'users');
    const q = query(userRef, where("uid", "==", user.uid));
    
    onSnapshot(q, (snapshot) => {
      if (snapshot.empty) {
        console.log("未找到对应用户数据");
        return;
      }
      // UID唯一，直接取第一个文档数据
      const userData = snapshot.docs[0].data();
      console.log("用户角色：", userData.role);
      // 可将角色存入状态，比如setUserRole(userData.role)
    }, (error) => {
      console.error("查询用户数据出错：", error);
    })
  })
  .catch(error => {
    setErrorMessage(error.message);
  });

如果不需要实时监听，仅登录时获取一次数据，建议用getDocs替代onSnapshot：

// 替换原onSnapshot部分
getDocs(q)
  .then(snapshot => {
    if (snapshot.empty) {
      console.log("未找到对应用户数据");
      return;
    }
    const userData = snapshot.docs[0].data();
    console.log("用户角色：", userData.role);
  })
  .catch(error => {
    console.error("查询用户数据出错：", error);
  });

4. 字段名拼写/大小写错误 #

确认Firestore文档中的字段名是uid（全小写），和代码中where("uid", "==", user.uid)的字段名完全一致——Firestore字段名大小写敏感，比如写成UID会导致匹配失败。

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