Firebase Firestore查询如何组合多个OR逻辑的where条件

Firestore 默认链式调用where()方法生成的是AND关系的查询条件，要实现OR逻辑的多条件组合，需要使用官方提供的逻辑查询构造器实现，具体写法如下：

最新版本SDK实现（推荐） #

请先确认你的firebase-admin依赖版本 ≥ v11.0.0，低版本不支持内置OR查询能力，代码示例：

const admin = require('firebase-admin');
// 引入Filter构造器
const { Filter } = require('firebase-admin/firestore');
const db = admin.firestore();

// 构造OR组合条件
const orCondition = Filter.or(
  Filter.where("published", "!=", false),
  Filter.where("another_property", "!=", "some_value")
);

const snapshot = await db.collection(collectionId).where(orCondition).get();

注意事项 #

• 涉及!=运算符的OR查询需要提前配置对应复合索引，运行时如果抛出索引缺失错误，按照错误提示创建对应索引等待生效即可
• 如果需要同时嵌套AND和OR逻辑，可以在Filter.or内嵌套Filter.and构造器实现多逻辑组合

低版本SDK兼容方案 #

如果你使用的SDK版本不支持内置OR查询，可以分开执行两个单条件查询，在代码层合并去重结果：

const db = admin.firestore();

// 并行执行两个单条件查询
const [pubSnapshot, propSnapshot] = await Promise.all([
  db.collection(collectionId).where("published", "!=", false).get(),
  db.collection(collectionId).where("another_property", "!=", "some_value").get()
]);

// 按文档ID去重合并结果
const resultMap = new Map();
pubSnapshot.forEach(doc => resultMap.set(doc.id, doc));
propSnapshot.forEach(doc => resultMap.set(doc.id, doc));

// 最终查询结果数组
const finalResults = Array.from(resultMap.values());

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