话说回来，

• SpringBoot这个分页坑。我踩了三天才爬出来

在SpringBoot开发中，分页功能几乎是每个涉及数据列表展示的项目都会用到的功能。Spring Data JPA和MyBatis等ORM框架提供了便捷的分页支持。特别是Spring Data JPA的Pageable接口和MyBatis-Plus的IPage接口，让开发者能够快速实现分页查询。 只是在实际开发中，分页功能背后隐藏的坑却不少。 怎么说呢，最近，我在一个项目中因为分页问题整整调试了三天最终才找到问题的根源。

基本实现方式

Spring Data JPA 分页

Spring Data JPA提供了Pageable接口和Page类，开发者可以这样做实现分页：

@Repository
public interface UserRepository extends JpaRepository {
Page findAll;}
@Service
public class UserService {
@Autowired
private UserRepository userRepository;public Page getUsers {
Pageable pageable = PageRequest.of;return userRepository.findAll;}
}

MyBatis-Plus 分页

MyBatis-Plus提供了IPage接口和Page类，分页实现如下：

@Service
public class UserService {
@Autowired
private UserMapper userMapper;public IPage getUsers {
Page pageParam = new Page<>;return userMapper.selectPage;}
}

常见坑点与痛点分析

1️⃣ 分页参数传递不当

• 痛点：前端传递的 page/size 参数可能为 0、负数或空值，导致查询失败或返回异常结果。
• 原因：
  • SJPA 的 PageRequest.of: 若 page <0 ,抛出 IllegalArgumentException。
  • M-P 的 Page: 对负数有默认处理。但 size <= 0 ,查询结果异常。
• 方法：
  • Avoid negative or zero values：在 Service 层做校验并给默认值。
  • Bare minimum：使用

    if page = 0;if size = DEFAULT_SIZE;

2️⃣ 深分页性能低下

• 痛点："查询第1000页的数据时我感觉数据库像打洞一样慢".
• 原因：
• Mysql LIMIT offset+size 在 offset 大时扫描大量行导致 CPU、IO 高峰。
• SJPA 和 M-P 默认都使用此方式。

3️⃣ 排序字段非唯一导致翻页重复或缺失数据

• 痛点："翻到第二页时我发现上一页的数据又出现了！".
• Cause:
  • 排序字段不是唯一值。SQL 随机返回相同排序值行，从而导致跨页重复或遗漏。
  • 如果仅按 name 排序，同名记录会被交错分布到不同页。

Solution:

• 将主键 id 加为二级排序：Sort.by.and). 如下示例这方面，

 pre>Sort sort = Sort.by.and);Pageable pageable = PageRequest.of;pre>