Flutter Firebase Firestore集合快照异常：存在文档却返回0个

核心问题分析 #

你调用 collection("test_history").get() 尝试获取 test_history 集合下的文档却返回0，但控制台显示该集合下存在 driverslicense_exam 文档，同时能正常读取该文档下的 jules 子集合，主要有以下两种常见原因：

1. Firestore安全规则限制了父集合的读取权限 #

Firestore默认禁止所有客户端读写操作。如果你的安全规则仅允许读取 test_history/driverslicense_exam/jules 这类子集合，却未授权读取 test_history 集合本身的文档，就会出现这种情况。

检查并调整安全规则，确保允许读取 test_history 下的文档：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /test_history/{docId} {
      // 测试阶段可临时开放读取，生产环境需替换为实际权限校验（如用户登录验证）
      allow read: if true;
      // 保留子集合的读取权限（如果需要）
      match /{subCollection}/{subDocId} {
        allow read: if true;
      }
    }
  }
}

2. 父文档为空（仅因存在子集合显示在控制台） #

Firestore控制台会显示带有子集合的空文档，但这类没有任何字段的空文档，部分情况下客户端查询可能无法正确返回（虽官方文档说明get()会返回空文档，但可排查确认）。

验证方式：打开Firestore控制台的 driverslicense_exam 文档，添加任意字段（比如 createdAt: serverTimestamp()），重新运行查询测试。

快速验证步骤 #

1. 确认 firebaseManager.db 指向的是你当前操作的Firestore实例（避免误连测试/其他环境数据库）。
2. 临时将安全规则设为开放读取（测试用），重新执行代码，若返回1则说明问题出在权限配置。
3. 检查 driverslicense_exam 文档是否包含至少一个字段。

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