Spring Data MongoDB分页异常：仅跳过1条数据的问题解决

问题分析 #

你遇到的分页异常（page=1时仅跳过1条数据），核心原因是MongoDB分页查询缺少稳定的排序条件。当未指定排序字段时，MongoDB默认会按文档的存储顺序（或_id的隐含顺序，但这个顺序在数据更新/移动时可能变化）返回结果，导致skip()和limit()的游标位置不稳定，出现分页结果重叠、跳步错误的情况。

修复步骤 #

1. 给分页查询添加稳定排序字段 #

必须为Pageable指定一个唯一且有序的排序字段（比如_id、创建时间createTime等），确保每次查询的结果集顺序一致。

修改控制器代码：

@GetMapping("/v1/get-all")
public List<UserEntity> getAll(@RequestParam Integer page, @RequestParam Integer size) {
    // 按_id升序排序，保证分页结果的稳定性
    Pageable pageable = PageRequest.of(page, size, Sort.by(Sort.Direction.ASC, "_id"));
    return service.getAll(pageable);
}

或修改服务层代码：

如果希望排序逻辑封装在服务层，也可以在Service中构造带排序的Pageable：

public List<UserEntity> getAll(Pageable pageable){
    // 合并传入的分页参数与固定排序规则
    Pageable sortedPageable = PageRequest.of(pageable.getPageNumber(), 
                                             pageable.getPageSize(), 
                                             Sort.by(Sort.Direction.ASC, "_id"));
    return userRepository.findAll(sortedPageable).stream().toList();
}

2. 验证分页逻辑 #

修改后重新测试：

• page=0、size=5：返回[1,2,3,4,5]
• page=1、size=5：返回[6,7,8,9,10]（符合预期的第二页数据）

关键说明 #

MongoDB的skip()和limit()机制依赖稳定的结果集顺序，没有排序的分页查询本质上是不可靠的——文档的物理存储位置可能因更新、压缩等操作发生变化，导致每次查询的结果顺序不一致，最终引发分页异常。

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