文章目录
- 一、概述
- 二、项目结构总览
- 三、核心组件详解
- 3.1 IPage 接口：分页能力的统一契约
- 3.2 Page 与 PageDTO：两种分页模型的选择
- 3.3 PaginationInnerInterceptor：分页拦截器核心
- 核心流程
- 关键行为说明
- 3.4 方言体系：多数据库适配
- IDialect 接口
- DialectFactory 方言工厂
- DialectModel 参数注入模型
- 3.5 Spring Boot 自动装配
- 四、分页插件配置指南
- 4.1 Spring Boot 自动配置方式
- 4.2 通过 Properties 注入配置
- 4.3 手动装配方式（非 Spring Boot）
- 4.4 多拦截器组合
- 五、数据库方言支持深度解析
- 5.1 MySQL 方言
- 5.2 PostgreSQL 方言
- 5.3 Oracle 方言
- 5.4 SQL Server 方言
- 5.5 DB2 方言
- 5.6 方言自动识别机制
- 六、IPage 接口使用指南
- 6.1 基础分页查询
- 6.2 带排序的分页查询
- 6.3 条件分页查询
- 6.4 链式查询分页
- 6.5 原生 SQL 分页
- 6.6 结果转换与序列化
- 6.7 分页参数控制项
- 6.8 Mapper 层与 MyBatis 的协作机制
- 七、分页性能优化体系
- 7.1 Count 查询优化
- 优化一：Order By 清理
- 优化二：Distinct / Group By 降级
- 优化三：Left Join 移除
- 完整优化流程
- 7.2 Limit 与分页上限控制
- 7.3 页码溢出处理
- 7.4 缓存策略
- 7.5 大数据量分页方案
- 7.6 索引优化建议
- 7.7 性能监控与诊断
- 八、分页应用场景实战
- 8.1 基础列表分页
- 8.2 多条件动态分页
- 8.3 多表关联分页
- 8.4 子查询分页
- 8.5 前后端数据格式标准化建议
- 九、常见问题与故障排查
- 9.1 Count 未执行或结果异常
- 9.2 Count 优化失败回退
- 9.3 排序拼接问题
- 9.4 页码溢出
- 9.5 序列化兼容性问题
- 9.6 无法识别数据库类型
- 9.7 分页插件未生效
- 十、总结
一、概述
在日常业务开发中，分页查询是最常见的数据展示方式之一。MyBatis-Plus 作为 MyBatis 的增强工具，提供了一套完善且高性能的分页解决方案，涵盖分页插件自动拦截、多数据库方言适配、SQL 自动优化、链式查询结合等核心能力。
本文基于 MyBatis-Plus 3.5.16 源码仓库，从架构设计、核心组件、配置方式、方言体系、性能优化策略到实际应用场景进行全方位深度解析，帮助开发者从入门到精通分页功能。
本文所有技术细节均源自 MyBatis-Plus 源码，确保信息准确可靠。
二、项目结构总览
MyBatis-Plus 分页功能的核心代码分布在以下模块中：
| 模块 | 关键文件 | 职责 |
|---|---|---|
mybatis-plus-core | IPage.java、OrderItem.java、BaseMapper.java | 分页契约定义、排序项、Mapper 基础接口 |
mybat |
