基于Firebase Firestore的Flutter点击页码/下一页按钮分页实现问询

Firestore 本身的设计是基于游标（也就是你用到的 startAfterDocument）做分页，原生没有支持直接按页码跳转的能力，你遇到的问题是这类 NoSQL 数据库分页的普遍场景，有几个适配不同规模的实现方案：

方案1：offset 直接分页（适合小数据量场景） #

如果你的业务总数据量不大（比如总条数在500以内，单页20条的话总页数不超过25），直接用 Firestore 自带的 offset 方法即可，不需要维护游标：

// 跳转到第 targetPage 页，pageSize 是每页条数
final query = FirebaseFirestore.instance
    .collection('你的集合名')
    .orderBy('排序字段')
    .limit(pageSize)
    .offset((targetPage - 1) * pageSize);
final res = await query.get();

这个方案实现成本最低，小数据量下性能完全够用，缺点是 offset 数值越大，查询性能越低，因为 Firestore 内部需要扫描跳过 offset 对应的所有索引条目，offset 超过1000之后性能会有明显下降。

方案2：预缓存分页游标（适合中等数据量场景） #

如果总数据量在几千到几万级别，需要支持流畅跳页，可以提前预缓存每一页的最后一条文档游标：

1. 用户进入列表页时，异步批量查询每一页的最后一条文档，只查单条不查整页，开销很低：

// 提前计算总页数，比如总条数存在单独的计数文档里
int totalPage = (totalCount / pageSize).ceil();
List<DocumentSnapshot?> pageCursors = List.filled(totalPage, null);
for(int i = 1; i < totalPage; i++) {
  // 只查每一页的最后一条文档
  final cursorQuery = FirebaseFirestore.instance
      .collection('你的集合名')
      .orderBy('排序字段')
      .limit(1)
      .offset(i * pageSize - 1);
  final res = await cursorQuery.get();
  pageCursors[i] = res.docs.firstOrNull;
}

2. 用户点击任意页码 targetPage 时，直接拿上一页的游标查询即可：

Query query = FirebaseFirestore.instance
    .collection('你的集合名')
    .orderBy('排序字段')
    .limit(pageSize);
if(targetPage > 1 && pageCursors[targetPage - 1] != null) {
  query = query.startAfterDocument(pageCursors[targetPage - 1]!);
}
final res = await query.get();

这个方案的优点是跳页查询性能极高，预缓存的开销也很小，缺点是如果总页数特别多（比如超过100页），预缓存的耗时会上升。

方案3：新增有序排序字段（适合大规模数据场景） #

如果你的业务数据量很大，需要支持任意页码的高性能跳转，可以给集合里的每个文档新增一个连续有序的排序字段，比如 serialId，用 Cloud Function 在文档创建时通过事务自动分配连续自增的数值。
之后跳页时直接用这个字段做范围查询即可，完全不需要 offset：

final startId = (targetPage - 1) * pageSize + 1;
final query = FirebaseFirestore.instance
    .collection('你的集合名')
    .orderBy('serialId')
    .where('serialId', isGreaterThanOrEqualTo: startId)
    .limit(pageSize);
final res = await query.get();

这个方案性能是最好的，支持百万级以上数据的任意跳页，缺点是需要额外维护自增字段，有并发冲突的处理成本，如果你的查询带多维度筛选条件，需要对应维护不同筛选维度下的有序字段，适配成本较高。

额外适配建议 #

实际业务中极少有用户会主动跳转到20页之后的内容，如果你不需要支持极端的深分页场景，可以限制用户最多直接跳转到前20页，超出范围的内容引导用户用筛选条件缩小范围，兼顾性能和用户体验。

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