Cloud Firestore查询报错FAILED_PRECONDITION：该查询需创建对应索引

这个问题在Firestore开发里太常见啦！你遇到的FAILED_PRECONDITION: The query requires an index错误，本质是因为你的查询用到了多条件过滤+排序的组合，Firestore的默认单字段索引没法处理这种请求，必须手动创建对应的复合索引。下面给你两种简单的解决方法：

方法一：直接用报错日志里的一键创建链接 #

Firestore其实很贴心，在抛出这个错误的时候，会在你的Logcat（或者终端日志）里附带一个自动生成索引的专属链接。你只需要：

• 打开你的日志输出，找到这条报错的完整内容
• 复制里面类似https://console.firebase.google.com/v1/r/project/[你的项目ID]/firestore/indexes?create_exact=[参数串]的链接
• 把链接粘贴到浏览器打开，会直接跳转到Firebase控制台的索引创建页面，确认字段和排序方向都和你的查询匹配后，点击「创建」按钮
• 等几分钟让索引构建完成（时间取决于你的数据量），再重新运行代码就没问题了

方法二：手动在Firebase控制台创建索引 #

如果找不到日志里的链接，也可以手动创建：

• 打开Firebase控制台，进入你的项目，切换到「Cloud Firestore」服务
• 点击顶部的「索引」标签页，然后点击「创建索引」
• 在「集合ID」里填写你的查询对应的集合名（也就是代码里的collectionName）
• 按照你的查询规则添加字段：
  • 先添加field1，操作选择「等于」（对应代码里的whereEqualTo）
  • 再添加field2，操作同样选择「等于」
  • 最后添加field3，选择你代码里orderBy对应的排序方向（升序/降序）
• 可以给索引自定义一个名称（也可以用系统自动生成的），然后点击「创建」
• 等待索引构建完成后，重新执行查询即可

补充说明 #

为什么需要这个索引？Firestore的默认索引只支持单个字段的过滤或排序，当你同时使用多个whereEqualTo（或其他过滤条件）加上orderBy时，就需要提前创建复合索引来告诉Firestore如何高效处理这种组合查询。

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