Firestore复合索引已创建仍失效？请求排查问题

问题核心 #

你的查询包含一个范围条件（expiryDate > currentDateTime）和一个等值条件（isAvailable == true），Firestore要求这类查询必须使用字段顺序匹配的复合索引，且索引创建后需要等待生效。

排查步骤 #

1. 直接使用错误提示的链接创建索引
   错误信息里提供的链接是Firestore根据你的查询自动生成的，点击它可一键创建完全匹配的索引，这是最快捷且不会出错的方式，避免手动创建时的字段顺序或方向错误。

2. 手动创建索引的正确规则
   如果要手动创建，必须严格遵循以下规则：

   • 字段顺序：先添加等值过滤的字段（isAvailable），再添加范围过滤的字段（expiryDate）
   • 排序方向：两个字段都选择升序（ASC）
   • 集合名称：确保索引创建在Listings集合上，和代码中的集合名完全一致

3. 等待索引生效
   Firestore复合索引创建后需要几分钟时间完成部署，创建完成前查询会持续报错，需耐心等待控制台中索引状态变为"已启用"。

4. 检查代码中的字段名
   确认代码里的字段名（expiryDate、isAvailable）和Firestore文档中的字段名完全一致，大小写敏感，不能有拼写错误。

补充说明 #

即使添加了orderBy，如果索引的字段顺序不匹配，查询仍然会失败。Firestore的复合索引严格绑定查询的过滤条件顺序和排序顺序。

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