Flutter Firestore 中获取 currentUser 文档下所有子集合的实现方法

注意：Flutter 官方 cloud_firestore 客户端SDK没有提供直接获取文档下所有子集合的原生API，该能力仅在服务端Admin SDK中默认支持，你可以选择以下两种适配方案实现需求。

方案1：客户端维护子集合名称数组（性能最优，适配聊天场景） #

每次为新联系人创建聊天子集合时，同步将子集合名称（一般为联系人ID）写入当前用户文档的专属数组字段即可，读取时直接取该字段内容，无需额外请求，性能最优。

写入示例（新建聊天会话时触发） #

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_auth/firebase_auth.dart';

Future<void> addNewContactChat(String contactId) async {
  final currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return;
  final userDocRef = FirebaseFirestore.instance.collection('users').doc(currentUser.uid);
  // 追加子集合名称到数组，自动去重
  await userDocRef.update({
    'chatContactIds': FieldValue.arrayUnion([contactId])
  });
}

读取示例 #

Future<List<String>> getChatContactList() async {
  final currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return [];
  final userDoc = await FirebaseFirestore.instance
      .collection('users')
      .doc(currentUser.uid)
      .get();
  return (userDoc.data()?['chatContactIds'] as List?)?.cast<String>() ?? [];
}

如果有删除聊天会话的需求，删除对应子集合后调用FieldValue.arrayRemove([contactId])更新数组字段即可 #

方案2：云函数封装Admin SDK能力 #

如果不想维护额外字段，可以部署云函数调用Admin SDK的listCollections接口获取子集合列表，客户端调用云函数拿结果。

云函数代码（Node.js） #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.getUserChatCollections = functions.https.onCall(async (data, context) => {
  // 鉴权校验，仅允许获取当前登录用户自己的子集合
  const uid = context.auth?.uid;
  if (!uid) throw new functions.https.HttpsError("unauthenticated", "用户未登录");
  const userDocRef = admin.firestore().collection("users").doc(uid);
  const collections = await userDocRef.listCollections();
  // 仅返回子集合名称列表，不返回子集合内的文档数据
  return collections.map(col => col.id);
});

Flutter客户端调用示例 #

import 'package:cloud_functions/cloud_functions.dart';
import 'package:firebase_auth/firebase_auth.dart';

Future<List<String>> getChatContactList() async {
  final currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return [];
  final callable = FirebaseFunctions.instance.httpsCallable('getUserChatCollections');
  final result = await callable.call();
  return (result.data as List).cast<String>();
}

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