Flutter中Firestore的collection.get()返回空结果问题排查

Firestore 数据结构 #

attendance (collection)
│
└─── 11-12-2076 (document)
    │
    └─── students (collection)
        │
        └─── d8281c00-fd7d-11ed-9234-3fbd868d12b9 (document)

路径示例 #

/attendance/5-29-2023/students/afe9e3f0-fd77-11ed-a0fc-596eeda998cb

代码问题 #

我尝试用以下代码获取attendance集合下的所有文档，但返回结果始终是空列表[]：

final attendanceCollection = FirebaseFirestore.instance.collection('attendance');

final QuerySnapshot attendanceSnapshot = await attendanceCollection.get();

print('attendanceSnapshot length is: ${attendanceSnapshot.docs.length}');

输出结果：

attendanceSnapshot length is: 0

我实际想实现的是遍历所有考勤文档及对应的学生数据，代码如下：

Future<void> exportAttendanceData() async {
    final attendanceCollection =
        FirebaseFirestore.instance.collection('attendance');
    final QuerySnapshot attendanceSnapshot = await attendanceCollection.get();

    for (final attendanceDoc in attendanceSnapshot.docs) {
      final studentsCollection =
          attendanceCollection.doc(attendanceDoc.id).collection('students');
      final QuerySnapshot studentsSnapshot = await studentsCollection.get();
      for (final studentDoc in studentsSnapshot.docs) {
        print(studentDoc.data()); // 打印每个学生文档的数据
      }
    }
  }

Firestore 安全规则 #

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

已尝试操作 #

• 检查安全规则配置
• 确认集合名称拼写无误
• 运行flutter doctor -v无错误或警告

核心问题 #

1. 为什么调用 .collection('attendance').get() 会返回空数组？
2. 如何正确获取attendance集合下的所有文档及其子集合数据？

1. 空数组的核心原因：安全规则过期 #

你的安全规则设置了时间限制request.time < timestamp.date(2023, 6, 24)，当前时间已超过2023年6月24日，所有读写请求都被规则拒绝，导致get()返回空结果。

2. 修复步骤 #

第一步：更新安全规则

修改规则中的时间限制，比如延长到未来日期，或测试环境临时放开权限（生产环境务必配置严格权限）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true; // 测试环境临时放开，生产环境需替换为合理权限逻辑
    }
  }
}

第二步：验证文档存在性

Firestore中，仅包含子集合但自身无任何字段的文档不会被get()返回——这类文档只是子集合的路径占位符，并非实际存在的文档。请确认：

• 打开Firebase控制台的Firestore页面，检查attendance集合下的日期文档（如11-12-2076）是否存在
• 若文档仅作为子集合容器，给每个日期文档添加至少一个字段（比如createdAt: timestamp()），确保文档被系统识别为有效文档

第三步：正常遍历数据

修复安全规则和文档存在性问题后，你的exportAttendanceData()代码即可正常运行。如果需要优化性能，可以用并行处理批量获取子集合数据：

Future<void> exportAttendanceData() async {
  final attendanceCollection = FirebaseFirestore.instance.collection('attendance');
  final attendanceSnapshot = await attendanceCollection.get();

  // 并行获取所有学生集合数据，提升效率
  await Future.wait(attendanceSnapshot.docs.map((attendanceDoc) async {
    final studentsSnapshot = await attendanceCollection
        .doc(attendanceDoc.id)
        .collection('students')
        .get();
    studentsSnapshot.docs.forEach((studentDoc) {
      print(studentDoc.data());
    });
  }));
}

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