Firebase Firestore如何使用array-contains-any按数组匹配数排序并支持分页

Firestore 原生没有直接提供基于 array-contains-any 匹配元素数量的排序能力，但有两种可落地的工程方案可以实现查询端排序，适配分页需求：

方案1：预计算匹配分数字段 + 复合索引 #

• 实现逻辑：先梳理业务中 array-contains-any 的高频查询参数枚举，在文档写入/更新时，预计算该文档针对每一类高频查询的匹配元素数量，存储为独立的整数字段，比如常用查询的匹配维度是用户标签，就新增 tag_match_score 字段存匹配计数。
• 查询逻辑：直接搭配 array-contains-any 查询条件，按预存的分数字段做排序，提前建好对应复合索引（array-contains-any 用到的数组字段 + 排序用的分数字段），即可完全兼容 Firestore 原生游标分页逻辑。
• 适用场景：array-contains-any 的查询参数为固定高频枚举值的业务场景。
• 限制：不支持完全动态、无规律的自定义查询数组。

方案2：使用 Firestore 向量搜索实现动态匹配排序 #

如果你的业务需要支持任意动态的 array-contains-any 查询参数，可以用 Firestore 原生向量搜索能力实现：

• 实现逻辑：将目标数组的所有可能枚举值映射为固定维度的索引，把每个文档的数组字段转成 one-hot 向量存储，查询时将 array-contains-any 的输入数组也转成同维度 one-hot 向量，使用点积作为相似度计算方式做向量查询，返回的相似度得分恰好等于两个数组的匹配元素数量，结果天然按匹配数从高到低排序。
• 操作要求：
  • Firestore SDK 版本 >= 11.10.0
  • 数组的所有可能枚举值总数不超过 2048（Firestore 单向量最高支持 2048 维）
  • 提前为向量字段创建点积类型的向量索引
• 适用场景：需要支持动态查询数组、枚举值数量可控的场景。

注意：不要尝试通过云函数实时计算匹配分数后再分页，该方案无法兼容 Firestore 原生游标分页逻辑，额外增加的计算延迟和成本远高于上述两种方案。

内容的提问来源于stack exchange，提问作者Fernando Contreras Aguilar