Firebase Firestore January 2022集合含2个文档，Flutter应用遍历仅显示1个的问题咨询

遇到这种Firebase Firestore里明明有两个文档，但Flutter应用只读取到一个的情况，我帮你梳理几个最常见的排查方向，大概率能定位问题：

• 权限规则拦截：这是最容易踩的坑。Firebase的安全规则可能限制了应用只能读取其中一个文档，另一个被规则挡在了外面。你可以先在测试环境临时放宽规则（注意上线前一定要改回去）：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if request.time < timestamp.date(2024, 12, 31);
      }
    }
  }
  

  改完后重启Flutter应用，如果能看到两个文档，那就是权限规则的问题，后续再针对性调整January 2022集合的读取权限即可。

• 查询代码存在过滤或拼写错误：检查你Flutter里的查询逻辑，是不是不小心加了多余的where过滤条件，或者集合名称写错了？比如把January 2022写成了january2022（大小写和空格都要完全匹配）。正确的基础查询应该是这样的：

  final janCollection = FirebaseFirestore.instance.collection('January 2022');
  final snapshot = await janCollection.get();
  snapshot.docs.forEach((doc) {
    print('文档ID: ${doc.id}, 数据: ${doc.data()}');
  });
  

  如果代码里有limit(1)或者错误的where子句，自然只会拿到一个文档。

• 本地缓存未同步：Firestore默认会启用本地缓存，如果其中一个文档是刚添加的，可能还没同步到应用的本地缓存里。你可以强制从服务器拉取最新数据，绕过本地缓存：

  final snapshot = await janCollection.get(GetOptions(source: Source.server));
  

  这样就能直接获取Firebase服务器上的最新数据，排查是不是缓存同步的问题。

• 文档数据格式异常：虽然少见，但如果某个文档包含Flutter无法解析的数据类型（比如特殊的自定义字段），遍历的时候可能会抛出异常被忽略，导致看起来只读取到一个文档。你可以在遍历的时候加上错误捕获，看看有没有报错：

  snapshot.docs.forEach((doc) {
    try {
      print('文档ID: ${doc.id}, 数据: ${doc.data()}');
    } catch (e) {
      print('读取文档${doc.id}出错: $e');
    }
  });
  

  如果有报错，就需要调整那个文档的数据结构，改成Flutter支持的类型。

• 项目环境不匹配：最后检查下你的Flutter应用配置的Firebase项目，是不是和你在控制台查看的项目不是同一个？有时候会不小心把测试项目和生产项目搞混，导致两边的集合数据不一样。

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