MyBatis需借助PageHelper等插件实现数据库物理分页；引入对应依赖，配置方言等参数，调用startPage()后执行单次查询即生效，并可选搭配PageInfo获取分页信息。
MyBatis 本身不内置物理分页功能，需借助第三方分页插件（如 PageHelper）实现数据库层面的分页查询（即生成 LIMIT、ROWNUM 或 OFFSET FETCH 等语句），避免内存中全量查出再截取，提升性能。
引入 PageHelper 依赖
在 pom.xml 中添加：
<dependency> <groupId>com.github.pagehelper</groupId> <artifactId>pagehelper-spring-boot-starter</artifactId> <version>1.4.7</version> <!-- 推荐使用与 MyBatis 版本兼容的最新稳定版 --> </dependency>
若用原生 Spring + MyBatis（非 Spring Boot），则需手动配置 PageInterceptor 到 SqlSessionFactory。
配置分页插件参数（Spring Boot）
在 application.yml 或 application.properties 中设置常用选项：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
pagehelper: helper-dialect: mysql # 数据库方言，支持 mysql/oracle/postgresql/h2/hsqldb/sqlserver2012 等 reasonable: true # 启用合理化分页：页码 ≤ 0 → 第一页；页码 > 总页数 → 最后一页 support-methods-arguments: true # 允许在 Mapper 方法中直接传入 RowBounds 或 PageRowBounds 参数 params: count=countSql # 分页时自动解析 count 查询语句的 key 名（默认值，一般不需改）
在业务代码中使用分页
调用 PageHelper.startPage() 开启分页，其后紧跟着执行的单次查询即生效：
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
PageHelper.startPage(1, 10); // 第 1 页，每页 10 条
List<User> users = userMapper.selectAll(); // 实际执行 SELECT * FROM user LIMIT 0,10
<p>// 获取分页信息（可选）
PageInfo<User> pageInfo = new PageInfo<>(users);
System.out.println("总条数：" + pageInfo.getTotal());
System.out.println("总页数：" + pageInfo.getPages());</p>-
注意顺序：必须在查询前调用
startPage，且仅对下一次查询生效；多次查询需重复调用。 - 推荐搭配 PageInfo：它封装了总记录数、页码、是否首页/末页等，适合返回给前端分页组件。
-
count 查询自动优化：PageHelper 会自动将
SELECT *替换为SELECT COUNT(*)并执行，无需手写 count 方法（除非有复杂关联需自定义）。
自定义 count 查询（可选）
当主 SQL 关联多表或含复杂条件，自动生成的 count 可能不准或性能差，可在 Mapper XML 中显式定义同名的 xxxCount 方法：
<select id="selectAll" resultType="User"> SELECT u.*, d.name AS deptName FROM user u LEFT JOIN dept d ON u.dept_id = d.id WHERE u.status = 1 </select> <p><select id="selectAllCount" resultType="long"> SELECT COUNT(u.id) FROM user u WHERE u.status = 1 </select></p>
PageHelper 会优先查找 selectAllCount 方法执行总数统计。
