Firestore无限滚动：时间戳与文档快照游标对比及优势解析

我在应用中实现了无限滚动列表，页面加载时先订阅初始50条数据，用户向下滚动时再依次订阅后续50条数据。当前计划使用以下查询（首次调用不含startAfter语句），保存最后一条可见数据的createdAt时间戳，后续调用时传入该时间戳作为startAfter参数：

const firestoreQuery = query(
collectionGroup(firestore, 'users'),
orderBy('createdAt', 'desc'),
startAfter(Timestamp.fromDate(new Date(startValue))), // 首次调用为空
limit(50));

但Firestore文档更推荐传入完整的最后一个文档快照作为查询游标而非时间戳，请问这种方式为何更优？能解决第一种方案存在的哪些问题？注：滚动过程中新增的条目需显示在列表中。

回答 #

• 避免数据重复或遗漏：如果多个文档的createdAt时间戳完全相同（比如同一秒创建了多条数据），用时间戳做startAfter参数时，要么会跳过所有时间戳等于该值的文档，要么会重复加载部分数据，直接导致数据漏取或重复。而文档快照包含文档的唯一ID，Firestore能精准定位到该文档的下一条，完全不会出现这类问题。
• 适配滚动时的新增数据：滚动过程中如果有新条目（按createdAt降序，新条目会排在列表顶部）被添加，用时间戳做游标可能会让新数据混入后续加载的旧数据里，或者重复加载之前的内容。而用文档快照作为游标，Firestore会基于文档的实际位置定位，新添加的条目会自然出现在列表顶部，不会干扰后续分页加载的连贯性。
• 查询逻辑更精准稳定：文档快照包含排序字段的完整信息和文档唯一标识，Firestore处理游标时无需额外判断，直接基于快照位置返回结果，不会因为客户端与服务器的时间差、时间戳精度问题导致查询偏差，比单独用时间戳的逻辑更可靠。

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