Firestore查询按start排序、按end过滤时报字段匹配错误如何解决？

错误原因 #

这是Firestore的内置查询限制：当查询中使用了范围类判断（大于、小于、大于等于、小于等于）的where条件时，查询的第一个orderBy字段必须与执行范围判断的字段完全一致。你的代码中对end字段做了大于等于的范围判断，但是第一个orderBy用了start字段，不符合这个规则，因此抛出错误。 #

解决方案 #

方案一：调整服务端排序顺序（推荐） #

先按范围查询的end字段排序，再按start字段降序排序，完全可以满足业务需求，只需要额外创建对应复合索引即可。
代码示例：

return FirebaseFirestore.instance
        .collection("content")
        .where("active", isEqualTo: true)
        .where("end", isGreaterThanOrEqualTo: DateTime.now())
        // 第一个orderBy必须匹配范围查询的end字段
        .orderBy("end")
        // 再按start字段降序排序
        .orderBy("start", descending: true)
        .snapshots();

操作说明：首次运行这段代码会触发索引缺失的错误，错误信息中会自动生成对应索引的创建入口，点击跳转至Firebase控制台确认创建即可，索引创建耗时通常在1-2分钟，完成后即可正常执行查询。

方案二：客户端排序 #

如果不想调整服务端排序逻辑，且查询返回的数据量较小，可以先拿到符合过滤条件的所有文档，在客户端对start字段做降序排序。
代码示例：

Stream<List<DocumentSnapshot>> getSortedContent() {
  return FirebaseFirestore.instance
      .collection("content")
      .where("active", isEqualTo: true)
      .where("end", isGreaterThanOrEqualTo: DateTime.now())
      .snapshots()
      .map((snapshot) {
        // 客户端按start字段降序排序
        final sortedDocs = snapshot.docs..sort((a, b) {
          final aStart = a.get("start") as DateTime;
          final bStart = b.get("start") as DateTime;
          return bStart.compareTo(aStart);
        });
        return sortedDocs;
      });
}

适用场景：仅适合查询结果数据量小于100条的场景，数据量过大会导致客户端性能下降。 #

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