知识条目 / Cloud Firestore

Firestore 复合索引与查询成本如何优化?

按等值、范围与排序顺序设计复合索引,控制返回文档数量并避免不必要的实时监听。

Firestore 按返回文档数量计费,缺少合适索引时查询会直接失败或需要客户端拼接。优化重点是减少扫描与返回的文档数,而不是单纯增加索引。

处理步骤

  1. 确认查询与索引匹配Firestore 要求复合查询有对应索引,控制台报错会给出创建链接。按等值字段、范围字段、排序字段的顺序设计索引。
  2. 控制返回文档数量使用 limit 与游标分页,避免一次拉取整个集合。实时监听会为初始快照和每次变更计费,非必要场景改为单次读取。
  3. 规避不支持的组合范围过滤与 array-contains 等操作有组合限制。必要时冗余字段或拆分集合,把复杂查询转成多次可索引的简单查询。
  4. 监控读取与延迟结合用量报表与查询性能数据确认热点集合,针对高频列表页做缓存或聚合文档,降低重复读取成本。

示例

db.collection("orders")
  .where("tenantId", "==", "t-1001")
  .where("status", "==", "PAID")
  .orderBy("createdAt", "desc")
  .limit(20)
  .get();

gcloud firestore indexes composite create \
  --collection-group=orders \
  --field-config=field-path=tenantId,order=ascending \
  --field-config=field-path=status,order=ascending \
  --field-config=field-path=createdAt,order=descending

索引构建需要时间,查询上线前先在测试项目验证。监听器在移动端会持续消耗流量与读配额。

关键词

firestore · 复合索引 · composite index · 查询 · 读次数 · 分页 · array-contains · 监听 · 成本 · gcp