Firestore降序排序配合startAfter分页查询无返回结果问题排查

核心原因 #

该问题90%以上由分页锚点快照的来源不匹配导致：
Firestore的startAfter定位逻辑完全依赖当前查询的排序规则，传入的lastDocSnapshot必须是和当前查询排序规则完全一致的前一页查询返回的快照，如果混用升序查询得到的快照作为降序查询的分页锚点，会出现定位错位，导致无数据返回。
其他可能的诱因包括单字段降序索引被手动禁用、SDK版本存在已知分页bug。

修复方案 #

1. 统一分页锚点来源 #

降序分页的锚点快照必须从同规则的降序查询中获取，完整流程示例：

// 第一步：查询降序第一页，不带startAfter参数
db.collection('actions')
  .orderBy('timestamp', 'desc')
  .limit(12)
  .get()
  .then(firstPageSnapshot => {
    // 存储当前页最后一条文档快照，作为下一页的分页锚点
    const lastDocOfFirstPage = firstPageSnapshot.docs[firstPageSnapshot.docs.length - 1]
    // 第二步：查询降序第二页，传入上一步拿到的同规则快照
    return db.collection('actions')
      .orderBy('timestamp', 'desc')
      .startAfter(lastDocOfFirstPage)
      .limit(12)
      .get()
  })
  .then(secondPageSnapshot => {
    // 此时即可正常拿到第二页数据
    console.log(secondPageSnapshot.empty)
  })

2. 检查索引配置 #

进入Firebase控制台 → 云Firestore → 索引页面，在单字段索引区域确认你用来排序的字段（如timestamp、整数字段等）的降序索引未被手动禁用。

3. 升级SDK版本 #

如果你使用的是低于9.0版本的Firebase JS SDK，升级到最新正式版即可修复部分已知的分页传参异常问题。

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