mybatis分页拦截本质是通过自定义interceptor拦截statementhandler.prepare()方法，在sql执行前动态重写sql添加limit/offset并处理count查询。
MyBatis 的分页拦截本质是通过自定义 Interceptor 拦截 StatementHandler 的执行过程，在 SQL 执行前动态重写 SQL，添加 LIMIT/OFFSET（或数据库特定的分页语法），同时拦截查询总数逻辑，实现物理分页。
理解拦截目标和时机
MyBatis 插件只能拦截四大核心接口：Executor、ParameterHandler、ResultSetHandler 和 StatementHandler。分页必须在 SQL 生成并准备执行前介入，因此最合适的拦截点是 StatementHandler 的 prepare() 方法 —— 此时 SQL 已经完成动态解析（#{xxx} 替换），但尚未编译为 PreparedStatement。
注意：不能拦截 Executor 的 query()，因为此时 SQL 已固定，且分页参数未注入；也不能只改 BoundSql 而不处理参数绑定，否则 OFFSET/LIMIT 值无法正确设置。
编写分页拦截器（PaginationInterceptor）
实现 Interceptor 接口，用 @Intercepts 指定拦截 StatementHandler.prepare(Connection, Integer) 方法：
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 在
intercept()中获取原始BoundSql，提取原始 SQL 和参数 - 判断是否需要分页（例如检查参数中是否存在
Page对象或pageNo/pageSize） - 使用数据库方言（如 MySQL、Oracle、PostgreSQL）生成带分页的 SQL，例如 MySQL 改为
SELECT * FROM t_user LIMIT #{pageSize} OFFSET #{offset} - 构造新的
BoundSql，并确保分页参数（pageSize、offset）被加入到参数映射中 - 用新
BoundSql替换原StatementHandler的内部 boundSql
支持 count 查询自动补全
真实分页需总记录数，常见做法是在同一次请求中自动执行一条 COUNT 查询。可在拦截器中识别分页请求后：
- 解析原始 SQL，剥离 ORDER BY，包装为
SELECT COUNT(*) FROM (original_sql) tmp_count - 复用原 SQL 的参数映射，创建独立的 count BoundSql
- 通过
Executor.query(..., countBoundSql, ...)手动触发一次 count 查询，并将结果存入 ThreadLocal 或 Page 对象 - 避免重复拦截 count 查询（加标记位或跳过已含 COUNT 的 SQL）
注册插件并配置分页参数
在 MyBatis 配置文件（mybatis-config.xml）或 Java Config 中注册插件：
业务层调用时，只需传入封装了 pageNum 和 pageSize 的对象（如 PageHelper 的 PageHelper.startPage(1, 10)），或直接在 Mapper 参数中传 Page<user></user> 实例，拦截器会自动识别并生效。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
