Firestore递归查询失效，如何高效筛选符合条件的Guest数据

我的Guest数据结构如下：

{
 name: 'Frank',
 date: '2022-12-12',
 tags: ['REMOVED', 'COMPLETED'],
 state: 'BOOKING',
 ...
}

原本通过以下Firestore查询获取数据：

query = query.where("date", "<=", startDate);
query = query.where("date", ">=", endDate);
query = query.where("state", "==", "BOOKING");

现在需要获取第一页的50条Guest数据，且过滤掉带有"REMOVED"标签的记录，但Firestore不允许在多属性查询中混用不等式，无法直接添加：

query = query.where("tags", "not-in", ["REMOVED"]);

尝试通过递归调用查询，直到凑够50条符合要求的数据，但递归逻辑未按预期工作。同时也清楚当前tags字段设计存在不足，想知道：

1. 除了递归查询外，是否有更高效的实现方式？
2. Firestore递归查询的推荐实现方式是什么？

一、更高效的替代方案：优化数据结构 #

Firestore的查询限制本质是引导开发者优化数据建模，针对这个场景，有两种可行的结构优化方式：

• 拆分布尔字段：把需要频繁过滤的标签单独拆成布尔字段，比如新增isRemoved: boolean。这样查询可以直接写成：

  query = query.where("date", "<=", startDate);
  query = query.where("date", ">=", endDate);
  query = query.where("state", "==", "BOOKING");
  query = query.where("isRemoved", "==", false);
  

  这种方式完全符合Firestore的查询规则，且能直接拿到符合要求的50条数据，性能最优，是优先推荐的方案。
• 重构标签存储为映射：把tags数组改成键值对形式，比如tags: { REMOVED: true, COMPLETED: true }，查询时可以用：

  query = query.where("tags.REMOVED", "!=", true);
  

  同样能避开多属性不等式混用的限制，不过需要注意Firestore对嵌套字段索引的自动创建规则，确保查询能命中索引。

二、正确的递归查询实现 #

如果暂时无法修改数据结构，递归查询的核心是分页游标（Cursor）的正确传递，避免重复查询同一批数据，同时控制递归终止条件。以下是推荐的实现逻辑：

async function fetchValidGuests(startDate, endDate, limit = 50, cursor = null, collected = []) {
  // 构建基础查询
  let query = db.collection('guests')
    .where("date", "<=", startDate)
    .where("date", ">=", endDate)
    .where("state", "==", "BOOKING");

  // 如果有游标，从游标位置开始查询
  if (cursor) {
    query = query.startAfter(cursor);
  }

  // 查询一批数据（建议每次查询比需要的多一些，减少递归次数，比如查100条）
  const snapshot = await query.limit(Math.min(limit * 2, 100)).get();

  if (snapshot.empty) {
    // 没有更多数据，返回已收集的结果（可能不足50条）
    return collected;
  }

  // 过滤掉带REMOVED标签的记录
  const validGuests = snapshot.docs.filter(doc => !doc.data().tags.includes("REMOVED"));
  collected = [...collected, ...validGuests];

  // 检查是否已凑够数量
  if (collected.length >= limit) {
    // 只返回前50条
    return collected.slice(0, limit);
  }

  // 获取最后一个文档作为下一页的游标，继续递归
  const lastDoc = snapshot.docs[snapshot.docs.length - 1];
  return fetchValidGuests(startDate, endDate, limit, lastDoc, collected);
}

// 调用示例
const firstPageGuests = await fetchValidGuests(startDate, endDate);

递归实现的注意点：

• 每次查询使用startAfter传递游标，避免重复获取已查询过的数据。
• 每次查询的数量可以设置为目标数量的2倍（或更多），减少递归调用次数，提升效率。
• 明确终止条件：要么凑够目标数量，要么没有更多数据可查。
• 注意Firestore的查询配额，避免短时间内多次递归导致配额耗尽。

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