React Native Firebase 中聚合查询的 where 条件失效问题解析

问题背景

在使用 React Native Firebase 的 Firestore 模块时，开发者发现 getAggregateFromServer 函数存在一个严重问题：当对集合组(collection group)执行聚合查询时，该方法会忽略所有附加的 where 条件子句。这意味着聚合操作会作用于整个集合，而不是预期的过滤后的数据集。

问题表现

具体表现为以下两种查询方式产生不同结果：

// 方式一：使用 count() 方法链 - 工作正常
const correct = await ref.count().get();
console.log("正确计数", correct.data().count);  // 返回符合 where 条件的计数

// 方式二：使用 getAggregateFromServer - 忽略 where 条件
const incorrect = await getAggregateFromServer(ref, { countCollection: count() });
console.log("错误计数", incorrect.data().countCollection);  // 返回整个集合的计数

这个问题尤其严重，因为 sum 和 average 聚合函数目前只能通过 getAggregateFromServer 使用，导致这些聚合功能在需要过滤条件时完全无法正常工作。

技术分析

经过 React Native Firebase 团队调查，发现这是一个特定于 iOS 平台的问题。在底层实现上：

1. iOS 原生代码未能正确将查询条件传递给聚合操作
2. Android 平台的实现则已经正确处理了查询条件
3. 问题主要影响集合组(collection group)查询

解决方案

React Native Firebase 团队在版本 21.7.2 中修复了这个问题。修复内容包括：

1. 修正 iOS 原生代码中查询条件的传递逻辑
2. 确保所有过滤条件(where 子句)都能正确应用于聚合查询
3. 保持与 Android 平台行为的一致性

升级注意事项

虽然 21.7.2 版本修复了聚合查询的问题，但同时也引入了大量关于 API 变更的警告信息。这些警告是关于 React Native Firebase 正在向 Firebase Web 模块化 v9 SDK API 靠拢的过渡提示。

开发者需要注意：

1. 现有代码中使用的 v8 风格 API 将被逐步淘汰
2. 建议尽快迁移到新的模块化 API 风格
3. 迁移过程通常是机械性的，大多数 API 都有对应的新版本

最佳实践

对于需要使用聚合查询的开发者，建议：

1. 确保使用 21.7.2 或更高版本
2. 明确测试所有聚合查询的过滤条件是否生效
3. 考虑逐步迁移到新的模块化 API 风格
4. 对于跨平台应用，仍需验证 Android 和 iOS 的行为一致性

总结

React Native Firebase 的聚合查询功能在正确处理过滤条件后，为开发者提供了强大的数据分析能力。此次修复确保了数据聚合的准确性，特别是在需要对大型数据集进行条件筛选和统计的场景下。随着向模块化 API 的过渡，开发者将获得与 Firebase Web SDK 更一致的开发体验，有利于实现代码的跨平台复用。