Firestore查询返回空值：指定用户ID无法获取数据

我尝试执行以下Firestore查询，但返回的所有字段均为null：

result = await FirebaseFirestore.instance
          .collection("users")
          .doc('EOLjcTCCvMfsi9mnbNynAGwCo723')
          .get();
OnboardingUser user = OnboardingUser.fromFirestore(result.data(), null);

以下是将Firestore快照转换为对象的代码：

factory OnboardingUser.fromFirestore(
    DocumentSnapshot<Map<String, dynamic>> snapshot,
    SnapshotOptions? options,
  ) {
    final data = snapshot.data();
    return OnboardingUser(
      firstName: data?['firstName'],
      lastName: data?['lastName'],
      phoneNumber: data?['phoneNumber'],
      age: data?['age'],
      grade: data?['grade'],
      gender: data?['gender']);
}

已知信息： #

• 该功能截至昨日仍正常运行
• 指定ID的用户已存在于users集合中
• Firestore规则配置无问题（见附图）
• 更新：尝试其他用户ID可正常查询，仅该用户出现此问题

排查与解决步骤 #

1. 修正转换函数的调用参数（核心问题）
   你的fromFirestore函数第一个参数要求传入DocumentSnapshot类型，但你实际传的是result.data()（这是Map<String, dynamic>?类型），导致函数内部snapshot.data()无法正确获取数据。正确调用方式应为：

   OnboardingUser user = OnboardingUser.fromFirestore(result, null);
   

2. 检查文档字段名大小写匹配
   Firestore字段名大小写敏感，确认控制台中该文档的字段名（如firstName）和代码中读取的键完全一致，避免因大小写差异导致字段读取失败。

3. 打印原始快照数据验证
   在转换对象前打印快照原始数据，确认数据是否正常返回：

   print('原始快照数据：${result.data()}');
   

   如果打印结果中字段缺失或为空，说明数据本身存在问题；若数据正常，则聚焦转换逻辑排查。

4. 强制从服务器拉取数据
   可能是本地缓存了旧数据，尝试禁用缓存查询：

   result = await FirebaseFirestore.instance
          .collection("users")
          .doc('EOLjcTCCvMfsi9mnbNynAGwCo723')
          .get(GetOptions(source: Source.server));
   

5. 再次验证文档与权限

   • 确认Firestore控制台中该文档ID完全匹配EOLjcTCCvMfsi9mnbNynAGwCo723，无多余空格或字符
   • 临时将Firestore规则设为测试模式（仅限调试），排查是否为权限问题：

     rules_version = '2';
     service cloud.firestore {
       match /databases/{database}/documents {
         match /{document=**} {
           allow read, write: if true;
         }
       }
     }
     

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