Java分页查询核心是计算offset=(currentPage-1)pageSize和limit=pageSize,SQL按数据库语法加LIMIT/ROWNUM,需查count()保证total准确,并用PageResult统一封装结果。

Java中实现数据分页查询,核心在于控制SQL的起始位置(offset)和返回条数(limit),同时配合前端传参、后端封装与结果统一封装。不依赖框架也能写清楚,用MyBatis或JDBC均可,关键是理解分页参数计算逻辑和边界处理。
分页参数怎么算:currentPage 和 pageSize 是基础
前端通常传两个参数:currentPage(当前页码,从1开始)和pageSize(每页几条)。后端需转为数据库可用的 offset 和 limit:
- offset = (currentPage - 1) * pageSize
- limit = pageSize
注意:currentPage ≤ 0 或 pageSize ≤ 0 时要拒绝请求;pageSize 过大(如超过500)建议截断或报错,防SQL性能风险。
SQL层面怎么写:MySQL、Oracle、PostgreSQL写法不同
以MySQL为例,直接加 LIMIT 子句即可:
立即学习“Java免费学习笔记(深入)”;
SELECT * FROM user ORDER BY id DESC LIMIT #{offset}, #{pageSize}Oracle需用ROWNUM伪列(12c+可用OFFSET/FETCH),PostgreSQL支持标准 LIMIT/OFFSET。若用MyBatis,推荐用预计算offset,或在Mapper接口中用@Param注解传入两个参数,避免XML里硬写表达式。
怎么查总条数:count(*)不能少
分页响应一般要带 total(总记录数),用于前端渲染页码。常见做法是额外执行一条 COUNT 查询:
SELECT COUNT(*) FROM user WHERE status = 1注意两点:
- WHERE条件必须和主查询完全一致,否则total不准;
- 可考虑加缓存(如Redis存热点count),但要注意数据变更时及时失效。
结果怎么封装:统一Response + PageResult更专业
不要直接返回List,建议定义分页响应体,例如:
public class PageResultprivate long total;
private int pageNum;
private int pageSize;
private List
}
Controller层组装好再返回,前端拿到的是结构清晰的JSON,含总数、当前页、数据列表,便于通用分页组件复用。










