Flutter 如何从Firebase Firestore获取包含子集合的集合数据

核心说明 #

Firestore 的查询默认为 浅查询，单次 get() 操作只会返回你直接请求的文档/集合数据，不会自动拉取下属子集合的内容，需要主动发起子集合的查询请求获取对应数据。

实现方法 #

已知子集合名称（客户端直接实现） #

如果提前明确文档下的子集合名称，可以通过 Future.wait 并发请求主文档和所有子集合，相比串行请求效率更高，参考代码如下：

Future<Map<String, dynamic>> fetchSiteWithSubcollections() async {
  // 定义目标主文档引用
  final siteDocRef = FirebaseFirestore.instance
      .collection('sites')
      .doc('4R3aOMBFTjumYCbETDU8');
  
  // 并发发起主文档、所有子集合的查询请求，可按需添加更多子集合查询
  final requestResults = await Future.wait([
    // 查询主文档数据
    siteDocRef.get(),
    // 查询子集合1：按需替换为你实际的子集合名称
    siteDocRef.collection('devices').get(),
    // 查询子集合2：按需添加更多子集合查询
    siteDocRef.collection('operation_records').get(),
  ]);

  // 提取各请求的返回结果
  final siteDocument = requestResults[0] as DocumentSnapshot;
  final devicesCollection = requestResults[1] as QuerySnapshot;
  final recordsCollection = requestResults[2] as QuerySnapshot;

  // 组装完整数据后返回
  return {
    "site_base_info": siteDocument.data(),
    "bound_devices": devicesCollection.docs.map((doc) => doc.data()).toList(),
    "operation_history": recordsCollection.docs.map((doc) => doc.data()).toList(),
  };
}

未知子集合名称 #

Flutter 端的 Firestore SDK 未提供列举文档下所有子集合的 API，该能力仅支持在服务端通过 Firebase Admin SDK 实现。如果需要动态获取所有未知名称的子集合，建议在服务侧封装接口完成数据组装，再由客户端调用接口获取完整数据。

注意事项 #

• 子集合的查询会单独计算读操作次数，例如查询1个主文档+2个子集合，共计费3次读操作
• 若子集合数据量较大，建议搭配分页逻辑查询，避免一次性拉取过多数据导致应用卡顿

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