React Native Firebase Firestore 查询优化：支持单条件 and/or 查询

在 React Native Firebase 项目中，开发者经常需要构建动态查询条件。近期社区发现了一个关于 Firestore 查询构造器的功能限制问题，本文将详细分析这个问题及其解决方案。

问题背景

在 Firestore 查询中，and() 和 or() 方法用于组合多个查询条件。然而，React Native Firebase 当前实现要求这些组合查询必须包含至少两个条件，这在构建动态查询时会造成不便。

考虑以下常见场景：

query(
  userCollection,
  and(
    where('happy', '>', 10),
    ...(minSadness !== undefined ? [where('sadness', '>', minSadness)] : []),
  ),
)

当 minSadness 未定义时，and() 实际上只接收一个查询条件，此时会抛出错误。

技术分析

当前实现限制

React Native Firebase 的 Firestore 模块在 FirestoreFilter.js 中明确检查了查询条件数量：

if (queries.length < 2) {
  throw new Error(...);
}

这种实现与 Firebase Web SDK 的行为不一致。

官方 SDK 行为

经过验证，Firebase Web SDK 的 and() 和 or() 方法可以接受单个查询条件：

• 当传入单个条件时，直接返回该条件
• 当传入多个条件时，才执行实际的逻辑组合

这种行为更加灵活，特别适合构建动态查询的场景。

解决方案

临时解决方案

开发者可以创建包装函数来模拟官方 SDK 的行为：

import { and as firestoreAnd } from '@react-native-firebase/firestore';

const and: typeof firestoreAnd = (...queries) => {
  if (queries.length === 1) return queries[0];
  return firestoreAnd(...queries);
};

长期解决方案

React Native Firebase 团队确认这是一个功能差距，计划在未来版本中修复此问题，使其行为与官方 Web SDK 保持一致。

最佳实践建议

1. 动态查询构建：在条件不确定的情况下，先收集所有条件再构建查询
2. 条件预处理：对于可能为空的动态条件，使用空数组展开语法
3. 版本适配：关注 React Native Firebase 的更新，及时移除临时解决方案

总结

Firestore 查询构造器的灵活性对于构建动态应用至关重要。React Native Firebase 即将支持单条件 and()/or() 查询，这将使查询构建更加符合直觉和开发者的预期。在此之前，开发者可以使用包装函数作为过渡方案。