firebase-admin中Filter.or仅生效首个查询条件的问题求助

拥有包含author和users映射的parties文档，想要查询所有由用户创建，或用户存在于users映射中的文档，但Filter.or条件仅生效其中一个子句，交换顺序后也只生效另一个子句。

代码示例 #

const getParties = onCall({}, async (request) => {
  const userPath = new FieldPath("users", request.auth.token.email);
  return dbAdmin
    .collection("parties")
    .where(
      Filter.or(
        Filter.where(userPath, "!=", null),
        Filter.where("author.uid", "==", request.auth.uid)
      )
    )
    .get();
});

导入与初始化代码 #

import { initializeApp } from "firebase-admin";
import { getFirestore, Filter, FieldPath } from "firebase-admin/firestore";
import { onCall } from "firebase-functions/v2/https";
const app = initializeApp({...});

文档结构示例 #

{
  "author": {
    "uid": "foo-bar"
  },
  "users": {
    "example@test.com": {
      "uid": "quux-baz",
      "email": "example@test.com",
      "joinedAt": 1705951291621
    }
  }
}

Firestore的Filter.or查询要求所有子条件对应的字段组合必须存在复合索引，否则查询无法完整执行，只会匹配其中一个条件。

这里的核心问题：

1. 第一个条件检查的是动态映射键（users.[用户邮箱]）是否存在，由于邮箱是动态值，无法预先创建覆盖所有可能邮箱的复合索引。
2. 第二个条件匹配author.uid，两个条件无法共享有效的复合索引，导致Firestore只能执行其中一个子查询。

方案一：修改数据结构（推荐） #

将users映射改为数组存储用户标识（邮箱或UID），这样可以使用array-contains查询，且能与author.uid的条件创建复合索引。

修改后的文档结构：

{
  "author": { "uid": "foo-bar" },
  "participantEmails": ["example@test.com", "another@test.com"]
}

修改后的查询代码：

const getParties = onCall({}, async (request) => {
  const userEmail = request.auth.token.email;
  const userId = request.auth.uid;

  const query = dbAdmin.collection("parties").where(
    Filter.or(
      Filter.where("participantEmails", "array-contains", userEmail),
      Filter.where("author.uid", "==", userId)
    )
  );

  const snapshot = await query.get();
  return snapshot.docs.map(doc => doc.data());
});

随后在Firestore控制台创建复合索引：

• 集合：parties
• 字段：author.uid（升序） + participantEmails（升序）

方案二：拆分查询后合并结果 #

如果不想修改数据结构，可以分别执行两个独立查询，再合并去重结果：

const getParties = onCall({}, async (request) => {
  const userEmail = request.auth.token.email;
  const userId = request.auth.uid;
  const userPath = new FieldPath("users", userEmail);

  // 并行执行两个查询
  const [authorSnapshot, userSnapshot] = await Promise.all([
    dbAdmin.collection("parties").where("author.uid", "==", userId).get(),
    dbAdmin.collection("parties").where(userPath, "!=", null).get()
  ]);

  // 用文档ID去重，合并结果
  const uniqueParties = new Map();
  authorSnapshot.forEach(doc => uniqueParties.set(doc.id, doc.data()));
  userSnapshot.forEach(doc => uniqueParties.set(doc.id, doc.data()));

  return Array.from(uniqueParties.values());
});

这种方式不需要创建复合索引，通过客户端合并结果实现需求，但需注意：如果数据量较大，会增加读取次数和带宽消耗。

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