如何在Flutter使用Cloud Firestore时优先查询最新添加的文档

前置准备 #

首先需要保证集合内的每个文档都存储了时间维度的字段，推荐优先使用Firestore服务端时间戳，避免客户端本地时间不准导致排序错乱，新增文档时写入时间字段的示例代码如下：

FirebaseFirestore.instance.collection('你的集合名称').add({
  // 其他业务字段
  'createTime': FieldValue.serverTimestamp(),
});

按时间倒序查询文档 #

要实现最新添加的文档优先展示，只需要在查询时调用orderBy方法，将排序规则设置为倒序即可，基础查询示例如下：

QuerySnapshot queryRes = await FirebaseFirestore.instance
    .collection('你的集合名称')
    // 第一个参数为时间字段名，第二个参数descending设为true表示倒序
    .orderBy('createTime', descending: true)
    // 可选：数据量大时建议加分页限制，单次拉取指定数量的文档
    .limit(20)
    .get();

注意事项 #

• 首次执行该查询时会触发索引缺失报错，你可以打开Firebase控制台的报错提示链接，一键创建对应索引，等待几分钟索引生效后即可正常查询。
• 如果需要实现分页加载更多，可以记录上一次查询返回的最后一条文档快照，下次查询时通过startAfterDocument方法续拉，示例代码如下：

  // lastDoc为上一次查询拿到的最后一个DocumentSnapshot对象
  QuerySnapshot nextPageRes = await FirebaseFirestore.instance
      .collection('你的集合名称')
      .orderBy('createTime', descending: true)
      .startAfterDocument(lastDoc)
      .limit(20)
      .get();
  

• 历史存量文档如果没有createTime字段，排序时会默认排在最后，可批量补全存量文档的时间字段避免展示异常。

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