Firestore集合组使用StartAfter分页失效，重复返回相同文档

核心问题 #

Firestore的Query对象是不可变的，调用startAfterDocument()不会修改原变量，而是返回一个带新条件的新Query实例。你的代码里只是调用了这个方法，但没把新Query赋值回query，导致每次执行的都是最初的无分页查询，所以每次都返回前5条文档。

修正代码 #

DocumentSnapshot<Object?>? lastFetchedDoc;

Future<void> getReviews() async {
  Query<Map<String, dynamic>> query = firestore
            .collectionGroup("reviews")
            .where("city", whereIn: ['New York', 'Philadelphia', 'Washington'])
            .orderBy('time_of_posting', descending: true)
            .limit(5);

  if (lastFetchedDoc != null) {
      // 关键：将新查询对象赋值回query变量
      query = query.startAfterDocument(lastFetchedDoc!);
  }

  QuerySnapshot snapshot = await query.get();
  // 空结果时避免报错
  if (snapshot.docs.isNotEmpty) {
    lastFetchedDoc = snapshot.docs.last;
  }
}

额外提示 #

• 确保所有匹配文档的time_of_posting字段存在且类型统一（都是Timestamp），否则排序和分页可能出现异常。
• 处理空结果的情况，防止后续查询因lastFetchedDoc无效而出错。

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