Spring MongoTemplate分页查询不符合预期问题排查

你遇到的核心问题有两个：

• 缺少稳定排序规则：MongoDB默认查询无固定排序逻辑，仅依赖文档的物理存储顺序，这会导致分页结果不稳定，即使参数正确也可能返回非预期数据。
• 分页页码计算错误：PageRequest.of(page/2, pageSize)的页码逻辑不严谨，若前端传入的是1-based页码，这种整数除法会导致页码计算偏差，无法精准定位到最后一页。

1. 固定排序+直接指定最后一页（已知总记录数场景） #

要确保分页结果的顺序稳定，必须指定一个唯一排序字段（比如_id或业务时间字段），按降序排序后再取最后一页：

// 按_id降序排序，保证结果顺序固定
Sort sort = Sort.by(Sort.Direction.DESC, "_id");
// 总记录4条、pageSize=2时，最后一页的0-based页码是1
Pageable pageable = PageRequest.of(1, pageSize, sort);

// 构造带筛选条件的查询
Query query = new Query()
    .addCriteria(Criteria.where("organizationId").is("1eb6abcd-abcd-abcd-abcd-abcdcaeabcd")
        .and("workspaceId").is("63cede492d4bb527103deabf")
        .and("isActive").is(true))
    .with(pageable);

List<MyClass> lastTwoRecords = mongoTemplate.find(query, MyClass.class);

2. 动态计算最后一页（未知总记录数场景） #

如果无法提前确定总记录数，可以先查询总条数，再计算最后一页的0-based页码：

// 构建筛选条件
Criteria criteria = Criteria.where("organizationId").is("1eb6abcd-abcd-abcd-abcd-abcdcaeabcd")
    .and("workspaceId").is("63cede492d4bb527103deabf")
    .and("isActive").is(true);

// 查询总记录数
long totalCount = mongoTemplate.count(new Query(criteria), MyClass.class);
// 计算最后一页的0-based页码
int lastPage = (int) ((totalCount + pageSize - 1) / pageSize) - 1;

// 构造带排序的分页请求
Sort sort = Sort.by(Sort.Direction.DESC, "_id");
Pageable pageable = PageRequest.of(lastPage, pageSize, sort);

// 执行最终查询
Query dataQuery = new Query(criteria).with(pageable);
List<MyClass> lastTwoRecords = mongoTemplate.find(dataQuery, MyClass.class);

关键说明 #

• 为什么Compass查询正常？Compass临时查询时，文档的物理存储顺序刚好符合预期，但代码中若没有固定排序，后续数据更新或MongoDB内部存储调整会导致顺序变化，分页结果不可靠。
• 页码规则：Spring Data的PageRequest.of(page, size)中page是0-based索引（第一页为0，第二页为1），如果前端传入的是1-based页码，需先转换为0-based再使用。

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