Firestore多字段orderBy查询失败，报failed-precondition错误

这个failed-precondition错误的核心原因是：Firestore的多字段排序查询必须提前创建对应的复合索引，默认的单字段索引无法支持多字段排序的查询需求。

解决步骤 #

• 自动生成索引（最快捷）
  运行代码触发错误后，打开浏览器控制台（Console面板），Firestore会输出一条包含索引创建链接的完整错误信息。点击该链接，会直接跳转到Firebase控制台的索引创建页面，系统已自动填充好你需要的索引字段和排序规则，确认后点击创建即可。

• 手动创建复合索引

  1. 进入Firebase控制台，打开你的项目，选择Firestore数据库 -> 索引 -> 复合索引标签页。
  2. 点击添加索引，选择代码中对应的集合（collectionName指向的集合）。
  3. 在字段配置区域，依次添加：
     • 字段1：name.last，排序规则匹配你查询中的设置（默认升序，与orderBy('name.last')一致）
     • 字段2：name.first，排序规则同样匹配查询设置
  4. 可自定义索引名称（控制台也会自动生成），完成后点击创建索引。
  5. 等待几分钟，索引创建完成后重新运行查询即可。

注意事项 #

确保查询中orderBy的排序方向（升序/降序）与复合索引里设置的完全一致。例如如果查询用orderBy('name.last', 'desc')，索引里对应的name.last字段也要设为降序，否则仍会触发错误。

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