Firestore查询索引优化：解决动态属性过滤索引配额超限问题

问题根因 #

当前采用动态对象属性路径genres.${tag} == true的写法实现标签过滤时，Firestore会将每个动态路径（如genres.drama、genres.comedy、languages.en）识别为独立字段。涉及多字段组合过滤时，每一种字段路径的组合都需要单独创建复合索引，标签可选值越多，索引数量按笛卡尔积增长，很快会触及单项目200个复合索引的配额上限。
此前尝试的整对象等值匹配方案是严格字段全等校验，要求文档字段和查询对象的键值完全一致，无法匹配存在额外标签的文档，不符合业务需求。

最优落地方案 #

改用数组类型存储标签值，搭配Firestore原生的array-contains-all操作符实现包含匹配，仅需极少量索引即可覆盖全量查询场景。

第一步：改造数据结构 #

将原有的键值对标记结构，替换为直接存储标签值的数组结构：

// 改造后的数据结构
[
  {
    id: 1,
    genres: ["drama", "comedy"],
    languages: ["en"]
  },
  {
    id: 2,
    genres: ["animation", "action", "comedy", "drama"],
    languages: ["en", "fr"]
  }
]

存量数据可通过一次性批量迁移脚本完成转换：遍历每个文档的genres、languages对象，通过Object.keys()提取所有值为true的标签名，生成数组后覆盖原字段即可。

第二步：调整查询逻辑 #

使用array-contains-all操作符做数组包含匹配，该操作符的匹配规则为：文档数组字段包含查询传入的所有元素即可，允许数组存在额外元素，完全满足非严格匹配的需求。

import { query, where, collection } from "firebase/firestore";

const genresSelected = ["drama", "comedy"];
const langSelected = ["en"];

let q = query(collection(db, "your_collection_name"));
// 匹配同时包含所有选中题材的文档
q = query(q, where("genres", "array-contains-all", genresSelected));
// 匹配同时包含所有选中语言的文档
q = query(q, where("languages", "array-contains-all", langSelected));

索引成本说明 #

• 仅过滤单类标签（如只筛genres、不筛languages）的场景：无需手动创建索引，Firestore默认生成的单字段索引即可支持。
• 同时过滤genres、languages两类标签的场景：仅需手动创建1个复合索引，索引字段配置为genres (数组)、languages (数组)，即可覆盖所有标签组合的查询需求，无论两类标签下有多少种可选值，不需要为每个标签组合单独建索引。

方案限制说明 #

• 单次查询中传入array-contains-all的数组元素最多支持10个，即单次查询最多可同时选中10个同类型标签，可覆盖绝大多数内容筛选场景的需求。
• 若业务需要支持“匹配任意一个选中标签”的逻辑，可替换为array-contains-any操作符，注意单次查询最多只能对1个数组字段使用array-contains-any。

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