Flutter中如何基于父文档条件查询Firestore子集合？

问题翻译 #

我正在使用Flutter和Firebase Firestore，希望查询集合组，但仅需Firestore中特定父文档的子集合。此前我尝试先查询所有父文档，再遍历筛选条件，接着用特定文档ID查询子集合，但这种方式速度极慢。我有一个名为Shops的集合，其中每个文档包含logoColour字段和Customers子集合；Customers文档包含多个字段，我关注的是height字段。我想要创建查询，获取logoColour为yellow的Shops下，height>5的Customers。我仅找到一篇2021年的TypeScript相关帖子，想知道Flutter中是否可行？

解决方案 #

Flutter完全支持这种高效的集合组查询，不需要用之前的N+1遍历方案，核心是通过字段关联+集合组索引实现单次查询：

1. 给Customers文档添加父字段关联

因为集合组查询会遍历所有同名子集合，要筛选出属于logoColour: yellow的Shops下的Customers，需要在每个Customers文档中额外存储父Shop的logoColour字段（比如命名为shopLogoColour）。

新创建Customer时，同步从所属Shop文档获取logoColour值写入；现有Customer文档可以通过批量更新补全这个字段。

2. 创建集合组复合索引

在Firebase控制台的Firestore索引页面，创建针对Customers集合组的复合索引：

• 集合组：Customers
• 查询字段：shopLogoColour（等于） + height（大于）
• 排序规则：height升/降序均可（按需选择）

3. Flutter代码实现单次查询

直接通过collectionGroup方法发起带双条件的查询：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<List<DocumentSnapshot>> getTargetCustomers() async {
  final querySnapshot = await FirebaseFirestore.instance
      .collectionGroup('Customers')
      .where('shopLogoColour', isEqualTo: 'yellow')
      .where('height', isGreaterThan: 5)
      .get();
  
  return querySnapshot.docs;
}

性能优势对比

• 原方案是两次查询+遍历：先筛选符合条件的Shop，再逐个查询其Customers，属于N+1查询模式，延迟高且资源消耗大。
• 新方案是单次集合组查询，Firestore通过预建索引直接定位符合条件的文档，响应速度和资源占用都远优于原方案。

注意事项

• 若担心字段冗余，也可以存储Shop的文档ID，用where('shopId', whereIn: [符合条件的Shop ID列表])，但Firestore的whereIn最多支持10个值，当符合条件的Shop数量较多时，还是存储shopLogoColour更稳妥。

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