Flutter升级cloud_firestore2.5.x空安全后startAfterDocument分页失效

• cloud_firestore 2.0.0及以上版本将Query设计为不可变类型，所有修改查询条件的方法（包括startAfterDocument、where、limit等）都会返回全新的Query实例，不会修改原有实例。
• 你现有代码中调用startAfterDocument后没有将新的实例赋值给queryColl，分页条件实际未生效，最终执行的始终是初始的不带分页参数的查询，因此每次都返回第一页的重复数据。

将分页条件设置的代码修改为重新赋值给queryColl即可，修正后的完整代码如下：

Query<Map<String, dynamic>> queryColl = FirebaseFirestore.instance
.collection('customers')
.doc(customerId)
.collection('ledger_transactions')
.limit(iLimit)
.orderBy('created_at', descending: true);
if (lastDoc != null) {
  print('getCustomerLedger lastDoc != null ${lastDoc.id}');
  // 核心修改：将返回的新Query实例重新赋值给queryColl
  queryColl = queryColl.startAfterDocument(lastDoc!);
} 

QuerySnapshot<Map<String, dynamic>> snapshot = await queryColl.get();

• 确保created_at字段已经在对应集合中创建了索引，否则分页查询可能抛出异常或返回异常结果
• 确保传入的lastDoc为上一次查询返回的最后一个DocumentSnapshot<Map<String, dynamic>>类型对象，和查询的泛型类型匹配

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