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:00'，id为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;

这里的关键点：

1. 排序字段必须包含唯一性约束（本例用created_at+id组合）
2. WHERE条件使用"小于"比较实现游标定位
3. 必须保持前后查询的排序一致性

2.2 Java中的完整实现

public Page<Order> 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)))); } // 执行查询 List<Order> 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 性能优化技巧

1. 索引设计：确保游标字段和排序字段有复合索引

   CREATE INDEX idx_orders_user_created ON orders(user_id, created_at, id);

2. 游标缓存：对于热门查询，可以缓存游标位置

   // 使用Redis缓存游标信息 String cursorKey = "user:" + userId + ":orders:cursor"; redisTemplate.opsForValue().set(cursorKey, lastCreatedAt + ":" + lastId);

3. 批量预取：根据用户行为预测提前加载下一页数据

4. 与传统分页的对比

5. 常见问题解决方案

问题1：如何处理新增数据导致的分页紊乱？

解决方案：使用始终递增的游标字段（如自增ID或创建时间），避免使用可能修改的字段（如更新时间和排序权重）

问题2：游标分页如何支持跳转到指定页？

替代方案：

1. 估算跳转：根据平均每页数据量估算游标位置
2. 分段缓存：对热门查询区间预先生成游标锚点

问题3：MyBatis-Plus如何实现游标分页？

虽然MyBatis-Plus默认基于PageHelper的OFFSET分页，但可以自定义：

@Select("SELECT * FROM table WHERE id < #{cursor} ORDER BY id DESC LIMIT #{size}") List<Entity> selectByCursor(@Param("cursor") Long cursor, @Param("size") int size);

6. 生产环境注意事项

1. 游标失效处理：当游标对应的记录被删除时，需要设计降级方案。常见的做法是：

   • 返回第一页数据并提示
   • 使用容错查询（如忽略不存在的游标）

2. 安全防护：

   // 验证游标参数有效性 if (cursorId != null && cursorId <= 0) { throw new IllegalArgumentException("Invalid cursor"); }

3. 监控指标：

   • 分页查询响应时间
   • 游标命中率
   • 深页码请求占比

我在实际项目中发现，游标分页特别适合与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以内。