文章目录

• • 一、概述
  • 二、项目结构总览
  • 三、核心组件详解
  • • 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 分页插件未生效
  • 十、总结