Flutter中如何实现Firebase全集合按公共字段查询

Firestore 原生不支持直接遍历所有根集合做无范围限定的全局查询，所有查询必须明确指定查询的集合范围，根据你的集合结构可以选择下面三种落地方式：

方案1：集合组查询（仅适合同名集合场景） #

如果你要查询的、带公共字段的文档，全部存放在同名集合下（不管是根集合还是任意层级的子集合，只要集合名完全一致），直接用官方原生的集合组查询即可，性能最优：

1. 提前在Firebase控制台为公共字段创建集合组范围的单字段索引，否则查询会抛错
2. Flutter端实现代码：

/// 搜索公共字段匹配关键词的所有文档
/// 假设公共字段名为`commonField`，所有目标文档所在的同名集合名为`targetCollectionName`
Future<List<QueryDocumentSnapshot>> searchFromCollectionGroup(String keyword) async {
  final snapshot = await FirebaseFirestore.instance
      .collectionGroup('targetCollectionName')
      // 下面是前缀匹配的通用写法，如果是精确匹配直接用isEqualTo即可
      .where('commonField', isGreaterThanOrEqualTo: keyword)
      .where('commonField', isLessThanOrEqualTo: '$keyword\uf8ff')
      .get();
  return snapshot.docs;
}

注意：集合组查询会匹配数据库中所有和指定名称一致的集合，和集合所在的层级、父文档无关。

方案2：多集合并发查询合并结果（适合集合数量固定的小项目） #

如果你的目标文档分散在名称不同的根集合下（比如users、goods、articles等不同名集合，都带公共字段），且集合总数不多、总量固定，可以直接遍历所有目标集合并发查询，最后合并结果：

/// 提前配置所有需要参与搜索的集合名
const searchCollections = ['users', 'goods', 'articles', 'comments'];

Future<List<QueryDocumentSnapshot>> globalSearch(String keyword) async {
  List<QueryDocumentSnapshot> results = [];
  // 并发发起所有集合的查询请求
  final futures = searchCollections.map((colName) {
    return FirebaseFirestore.instance
        .collection(colName)
        .where('commonField', isGreaterThanOrEqualTo: keyword)
        .where('commonField', isLessThanOrEqualTo: '$keyword\uf8ff')
        .get();
  }).toList();
  // 等待所有请求返回后合并结果
  final snapshots = await Future.wait(futures);
  for (final snap in snapshots) {
    results.addAll(snap.docs);
  }
  return results;
}

注意：这个方案的读成本和集合数量、单集合数据量正相关，如果集合数量超过10个或者单集合数据量超过1万，不建议用这个方案，查询延迟和成本都会很高。

方案3：聚合搜索集合（生产环境推荐方案） #

如果是正式线上项目，最稳定可控的方案是单独维护一个搜索专用集合：

1. 新建一个根集合比如命名为search_index
2. 配置Cloud Functions触发器，监听所有需要参与搜索的集合的增/删/改操作：当文档变动时，自动把文档的公共搜索字段、原文档路径、搜索需要用到的展示字段同步写入search_index的对应文档
3. 做搜索时直接查询search_index这一个集合即可，拿到结果后如果需要完整文档内容，再根据存储的原路径拉取对应数据
   这个方案的优势是查询性能稳定、读成本低，后续扩展分词搜索、模糊匹配、权重排序都很方便，不会受原有业务集合的结构限制。

Firebase数据结构参考截图

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