Flutter中无法从Firebase子集合获取文件夹文档列表求助

架构老林

2026-8-12

解决Firestore无法获取folder集合文档列表的问题

我正在开发一款应用，需要构建邮件文件夹与笔记的三级层级结构（示意图：层级结构示意图）。目前无法获取folder2集合下的文档列表，执行以下代码后控制台输出为0，但能正常获取notes集合的所有条目：

var collection = FirebaseFirestore.instance
    .collection('user')
    .doc(widget.email)
    .collection('folder2');
await collection.get().then((snap) {
  data = snap.size;
  print(data);
});

排查解决步骤：

核对Firestore路径与数据结构
确认Firestore控制台中user/{widget.email}/folder2路径下确实存在文档，注意集合/文档名称的大小写敏感，比如是否实际是Folder2而非folder2；同时检查widget.email的取值是否准确，有没有空格、大小写偏差导致文档ID不匹配。
检查Firestore安全规则
若安全规则限制了folder2集合的读取权限，会直接返回空结果。确保规则允许当前用户读取该集合，示例规则如下：
```
match /user/{userId}/folder2/{doc} {
  allow read: if request.auth != null && request.auth.email == userId;
}
```

改用实时监听捕获错误信息
替换一次性获取为实时快照监听，能直接读取过程中的权限或路径错误：

FirebaseFirestore.instance
    .collection('user')
    .doc(widget.email)
    .collection('folder2')
    .snapshots()
    .listen((snap) {
      print('文档数量: ${snap.size}');
    }, onError: (error) {
      print('读取失败原因: $error');
    });