Flutter中如何合并两个Firestore查询并返回Query类型结果

Firestore 本身不支持把两个 Query 对象合并成一个单一的 Query——因为你的需求本质是逻辑或（OR），而原生 Query 只支持逻辑与（AND）组合条件。不过有两种靠谱的解决思路：

方案1：客户端分别执行查询，合并结果 #

先把重复的转换器抽出来减少冗余：

final lessonConverter = FirestoreDataConverter<Lesson>(
  fromFirestore: (snapshot, _) => Lesson.fromFirestore(snapshot),
  toFirestore: (lesson, _) => lesson.toFirestore(),
);

然后分别执行两个查询，在客户端合并结果：

// 定义两个查询
final publicLessonsQuery = lessons.withConverter(lessonConverter).where('private', isEqualTo: false);
final userPrivateLessonsQuery = lessons.withConverter(lessonConverter)
    .where('private', isEqualTo: true)
    .where('author', isEqualTo: uid);

// 获取两个查询的快照并合并数据
final publicSnapshot = await publicLessonsQuery.get();
final privateSnapshot = await userPrivateLessonsQuery.get();

final allLessons = [
  ...publicSnapshot.docs.map((doc) => doc.data()),
  ...privateSnapshot.docs.map((doc) => doc.data()),
];

如果需要实时监听数据变化，可以合并两个流（需要依赖 rxdart 包，或者用 Dart 原生流组合方式）：

final publicStream = publicLessonsQuery.snapshots();
final privateStream = userPrivateLessonsQuery.snapshots();

final combinedStream = Rx.combineLatest2(
  publicStream,
  privateStream,
  (publicSnap, privateSnap) {
    final publicLessons = publicSnap.docs.map((d) => d.data()).toList();
    final privateLessons = privateSnap.docs.map((d) => d.data()).toList();
    return [...publicLessons, ...privateLessons];
  },
);

这个方案的好处是不用修改现有数据结构，快速就能实现；缺点是两次查询会增加网络开销，且合并后的结果无法直接使用 Query 的分页、排序等原生功能。

方案2：调整数据结构，用单一Query实现（推荐） #

如果想直接用一个 Query 满足需求，可以给 Lesson 文档新增一个字段（比如 accessibleTargets）：

• 公开课程：accessibleTargets: ['public']
• 当前用户的私有课程：accessibleTargets: [uid]

然后用 Firestore 的 arrayContainsAny 条件查询：

final combinedQuery = lessons.withConverter(lessonConverter).where(
  'accessibleTargets',
  arrayContainsAny: ['public', uid],
);

这样一次查询就能拿到所有符合条件的课程，完全支持 Firestore 原生的分页、排序、实时监听，性能更优。

注意：arrayContainsAny 最多支持10个匹配元素，这里只用到两个，完全符合限制，后续扩展权限场景也能轻松适配。

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