1. 为什么需要游标分页在传统的分页实现中我们最常使用的是基于OFFSET/LIMIT的分页方式。这种方式看似简单直接但在处理大数据量时存在明显的性能瓶颈。当用户请求第1000页的数据时假设每页20条数据库实际上需要先扫描并丢弃前19980条记录这种操作的成本会随着页码的增加呈线性增长。游标分页Cursor-based Pagination的核心思想是不再使用页码作为分页依据而是用上一页最后一条记录的某个唯一标识游标作为下一页查询的起点。这种方式特别适合无限滚动的社交动态流实时更新的交易记录列表需要保持排序稳定的大型数据集提示游标字段的选择至关重要通常需要满足两个条件唯一性和有序性。常见选择包括自增ID、时间戳或组合索引字段。2. 游标分页的实现原理2.1 基础实现方案假设我们有一个用户订单表要实现基于创建时间的游标分页查询-- 第一页查询 SELECT * FROM orders WHERE user_id 123 ORDER BY created_at DESC, id DESC LIMIT 20; -- 获取下一页假设上一页最后记录的created_at为2023-05-15 14:30:00id为789 SELECT * FROM orders WHERE user_id 123 AND (created_at 2023-05-15 14:30:00 OR (created_at 2023-05-15 14:30:00 AND id 789)) ORDER BY created_at DESC, id DESC LIMIT 20;这里的关键点排序字段必须包含唯一性约束本例用created_atid组合WHERE条件使用小于比较实现游标定位必须保持前后查询的排序一致性2.2 Java中的完整实现public PageOrder getOrdersByCursor(Long userId, LocalDateTime cursorTime, Long cursorId, int size) { // 构建查询条件 BooleanBuilder builder new BooleanBuilder() .and(QOrder.order.userId.eq(userId)); if (cursorTime ! null cursorId ! null) { builder.and(QOrder.order.createdAt.lt(cursorTime) .or(QOrder.order.createdAt.eq(cursorTime) .and(QOrder.order.id.lt(cursorId)))); } // 执行查询 ListOrder orders queryFactory.selectFrom(QOrder.order) .where(builder) .orderBy(QOrder.order.createdAt.desc(), QOrder.order.id.desc()) .limit(size) .fetch(); // 判断是否还有下一页 boolean hasNext orders.size() size; return new Page(orders, hasNext); }3. 高级应用场景与优化3.1 多字段组合游标对于更复杂的排序需求可以扩展游标字段。例如电商商品列表可能需要综合排序// 按销量降序、评分降序、价格升序、ID升序的多维排序 .orderBy(QProduct.product.sales.desc(), QProduct.product.rating.desc(), QProduct.product.price.asc(), QProduct.product.id.asc()) // 对应的游标条件 .and(QProduct.product.sales.lt(lastSales) .or(QProduct.product.sales.eq(lastSales) .and(QProduct.product.rating.lt(lastRating)) .or(...)))3.2 性能优化技巧索引设计确保游标字段和排序字段有复合索引CREATE INDEX idx_orders_user_created ON orders(user_id, created_at, id);游标缓存对于热门查询可以缓存游标位置// 使用Redis缓存游标信息 String cursorKey user: userId :orders:cursor; redisTemplate.opsForValue().set(cursorKey, lastCreatedAt : lastId);批量预取根据用户行为预测提前加载下一页数据4. 与传统分页的对比特性游标分页OFFSET分页大数据量性能稳定高效随页码增加线性下降结果一致性强一致无跳页/重复可能产生跳页或重复实现复杂度中等简单用户界面适配仅支持加载更多支持传统页码导航深页码访问毫秒级响应可能超时5. 常见问题解决方案问题1如何处理新增数据导致的分页紊乱解决方案使用始终递增的游标字段如自增ID或创建时间避免使用可能修改的字段如更新时间和排序权重问题2游标分页如何支持跳转到指定页替代方案估算跳转根据平均每页数据量估算游标位置分段缓存对热门查询区间预先生成游标锚点问题3MyBatis-Plus如何实现游标分页虽然MyBatis-Plus默认基于PageHelper的OFFSET分页但可以自定义Select(SELECT * FROM table WHERE id #{cursor} ORDER BY id DESC LIMIT #{size}) ListEntity selectByCursor(Param(cursor) Long cursor, Param(size) int size);6. 生产环境注意事项游标失效处理当游标对应的记录被删除时需要设计降级方案。常见的做法是返回第一页数据并提示使用容错查询如忽略不存在的游标安全防护// 验证游标参数有效性 if (cursorId ! null cursorId 0) { throw new IllegalArgumentException(Invalid cursor); }监控指标分页查询响应时间游标命中率深页码请求占比我在实际项目中发现游标分页特别适合与Elasticsearch等搜索引擎配合使用。ES的search_after参数原生支持游标分页结合Java客户端可以实现高性能搜索分页SearchRequest request new SearchRequest(orders); SearchSourceBuilder sourceBuilder new SearchSourceBuilder() .query(QueryBuilders.termQuery(user_id, userId)) .sort(SortBuilders.fieldSort(created_at).order(SortOrder.DESC)) .sort(SortBuilders.fieldSort(id).order(SortOrder.DESC)) .size(size); if (cursorValues ! null) { sourceBuilder.searchAfter(cursorValues); }这种实现方式比数据库分页性能更高特别是在千万级数据量的场景下查询耗时仍能保持在50ms以内。