Java分页查询核心是合理协同分页参数传递、SQL构造与结果封装:1. 前端传page/size需校验并规范封装;2. 数据库优先用limit+offset,大数据量改游标分页;3. Java层应返回含总数、总页数等元信息的封装对象。

Java项目中实现分页查询,核心是控制每次从数据库取出的数据范围,避免一次性加载全部数据造成内存压力或响应延迟。关键不在Java代码本身多复杂,而在于分页参数传递、SQL构造、结果封装三者协同是否合理。
1. 前端传参:page和size要校验
前端通常传两个参数:page(当前页码,一般从1开始) 和 size(每页条数)。后端必须做基础校验:
- page ≤ 0 时默认设为 1;size ≤ 0 或过大(如 > 100)时设为默认值(如20)
- 建议统一用 PageRequest(Spring Data JPA)或自定义 PageParam 封装,避免散落的 int 参数
- 可加 @Min/@Max 注解约束,配合 @Valid 触发校验
2. 数据库层:用 limit + offset 或游标分页
主流关系型数据库(MySQL/PostgreSQL)推荐用 limit + offset 实现简单分页:
- SQL 示例:
SELECT * FROM user ORDER BY id LIMIT #{size} OFFSET #{offset} - offset = (page - 1) * size,注意不要手算错
-
大数据量时(如 offset > 10w),性能会明显下降 → 改用基于主键/时间戳的游标分页(如
WHERE id > last_id ORDER BY id LIMIT size)
3. Java层封装:返回带分页元信息的结果
不要只返回 List,应封装成含总记录数、总页数、当前页等信息的对象,例如:
立即学习“Java免费学习笔记(深入)”;
- Spring Boot 可直接返回 Page
(JPA)或 PageResult (自定义) - 手动查总数再查列表(两次SQL):先
SELECT COUNT(*) FROM user WHERE ...,再查数据 - MyBatis-Plus 提供 Page 对象和 IPage 接口,配合分页插件自动改写 SQL
4. 注意边界与一致性
分页容易忽略但影响体验的细节:
- 总数变更时(如别人刚删了数据),第一页可能变空,需提示“暂无数据”而非报错
- 排序字段必须固定(如 always ORDER BY create_time DESC),否则同页数据可能重复或丢失
- 高并发下,用游标分页比 offset 更稳定;若必须用 offset,考虑加缓存减少 count 查询
基本上就这些。分页逻辑不复杂,但参数处理、SQL写法、返回结构这三点没对齐,就容易出错或难维护。










