Firebase查询需索引但已创建索引仍报错求助

错误详情 #

FirebaseError: The query requires an index

{
  code: 'failed-precondition',
  customData: undefined,
  toString: [Function]
}

执行的查询代码 #

const q = query(videoRef, where("terms", "array-contains", term), orderBy("createdAt", "desc"));

已操作说明 #

已在Firebase控制台手动创建对应复合索引（terms字段设为array-contains匹配，createdAt字段设为降序排序），但仍触发上述错误。

排查方向 #

• 等待索引生效：新创建的Firebase索引通常需要1-5分钟完成部署，确认索引状态为「已启用」后再测试。
• 核对索引字段顺序：索引的字段顺序必须和查询逻辑完全匹配——先设置terms（对应where条件），再设置createdAt（对应orderBy条件），顺序颠倒会导致索引无法被匹配。
• 校验集合路径一致性：确认videoRef指向的集合路径，和索引绑定的集合路径完全一致（包括是否存在子集合、大小写是否匹配）。
• 分步测试查询：
  1. 移除orderBy条件，单独测试where("terms", "array-contains", term)查询，确认基础过滤逻辑正常。
  2. 单独测试orderBy("createdAt", "desc")查询，确认单字段排序无需额外索引（单字段排序默认支持）。
• 获取完整错误指引：调用error.toString()打印完整错误信息，Firebase通常会在错误信息中附带自动生成索引的链接，对比该链接生成的索引参数和你手动创建的是否一致。

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