Flutter 中如何获取 Firestore chatroom 文档下的子集合数据

Firestore 中父文档与下属子集合为独立存储层级，仅调用父文档的get()方法仅能获取父文档自身的字段值，不会自动拉取子集合内容，你需要主动指定子集合路径发起查询。

基础查询代码（单次拉取子集合所有文档） #

你可以直接在父文档引用后拼接子集合名称进行查询，示例代码如下：

Future<void> getChatroomSubContent(String UUID) async {
  try {
    // 先定位到目标父文档（对应你场景中的chatroom/9000）
    final chatroomDoc = _firestore.collection('chatroom').doc(UUID);
    // 替换引号内的内容为你实际的子集合名称，即可查询对应子集合
    final subCollection = chatroomDoc.collection('替换为你的实际子集合名称');
    // 拉取子集合下所有文档
    final subSnapshot = await subCollection.get();
    
    // 遍历读取子集合下的所有文档数据
    for (var doc in subSnapshot.docs) {
      print('子文档ID：${doc.id}，内容：${doc.data()}');
      // 可在此处将数据映射为你的业务实体类使用
    }
  } catch (err) {
    print('查询子集合出错：$err');
  }
}

你现有代码中的UUID参数传入9000，即可拉取到chatroom/9000下对应子集合的内容。

扩展场景：实时监听子集合变更 #

如果需要实现聊天消息实时同步的效果，可以改用snapshots()方法监听子集合的变更：

void listenChatroomSubContent(String UUID) {
  _firestore
      .collection('chatroom')
      .doc(UUID)
      .collection('替换为你的实际子集合名称')
      .snapshots()
      .listen((snapshot) {
    // 处理子集合的增删改变更
    for (var change in snapshot.docChanges) {
      switch (change.type) {
        case DocumentChangeType.added:
          print('新增子文档：${change.doc.data()}');
          break;
        case DocumentChangeType.modified:
          print('修改子文档：${change.doc.data()}');
          break;
        case DocumentChangeType.removed:
          print('删除子文档：${change.doc.data()}');
          break;
      }
    }
  });
}

注意事项 #

• Firestore 移动端SDK不支持直接获取某个文档下的所有子集合列表，该操作仅能在服务端Admin SDK中实现，移动端开发需要提前约定好子集合的命名规则。
• 如果需要同时拉取父文档数据+子集合数据，可以使用Future.wait合并异步请求提升查询效率：

Future<void> getFullChatroomData(String UUID) async {
  final parentDocFuture = _firestore.collection('chatroom').doc(UUID).get();
  final subCollectionFuture = _firestore.collection('chatroom').doc(UUID).collection('你的子集合名').get();
  final results = await Future.wait([parentDocFuture, subCollectionFuture]);
  
  final parentDocData = (results[0] as DocumentSnapshot).data();
  final subDocs = (results[1] as QuerySnapshot).docs;
  // 后续业务逻辑
}

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