mybatis-plus分页优化核心在于精准控制count查询、合理组织查询条件及规范联表分页。需关闭无意义总数统计、启用count语句优化、手动指定高效count sql;条件顺序应遵循最左前缀原则,时间范围放最前、高区分度字段靠后;联表分页推荐单表分页+关联补充或自定义xml实现;配置上须限制单页条数、开启溢出处理、指定准确dbtype、避免page复用。

MyBatis-Plus 的分页能力远不止 selectPage 那么简单。真正影响性能的,往往是 count 查询和条件组织方式,而不是分页本身。优化核心在于减少数据库扫描、避免子查询嵌套、让索引真正生效。
精准控制 count 查询,避开大表全扫
千万级数据下,SELECT COUNT(*) FROM (原始SQL) 这种默认 count 生成方式极易触发临时表或全表扫描。关键不是“要不要 count”,而是“怎么 count 更快”:
- 关闭无意义的总数统计:若前端只用“下一页”按钮(不显示总页数),设置
page.setSearchCount(false),跳过 count 步骤,响应时间直降 50% 以上 - 启用 count 语句优化:确保
optimizeCountSql = true(默认开启),MP 会自动把COUNT(*)简化为COUNT(1),并尝试剥离子查询;对单表且无 GROUP BY 的场景,直接生成SELECT COUNT(1) FROM table WHERE ... - 手动指定高效 count SQL:当业务允许误差容忍(如后台运营看趋势),可用近似 count,例如 MySQL 的
SELECT TABLE_ROWS FROM information_schema.TABLES,或给核心字段加覆盖索引后写count(索引列)
条件顺序与索引利用,让 where 走上快车道
QueryWrapper 的拼接顺序直接影响执行计划。数据库优化器依赖最左前缀原则,条件顺序错一位,可能就从索引查找变成全表扫描:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- 时间范围条件放最前:比如
between("create_time", start, end)必须是第一个条件,才能利用create_time索引的有序性 - 高区分度字段靠前:状态码(如 status=0)、类型标识(type IN (1,2))等低基数字段,应放在中后段,避免过早过滤掉大量数据
- 优先用 LambdaQueryWrapper:避免字符串硬编码字段名,既防拼写错误,也方便 IDE 提示和重构,间接提升条件构建准确性
联表分页不踩坑,避免 count 失效
多表 JOIN 后分页,MP 默认的 count 机制大概率失效——它无法智能识别 JOIN 后的主表别名或去重逻辑,常生成错误的子查询 count:
- 单表分页 + 关联字段补充:先用
selectPage查出主表 ID 列表,再批量查关联表(如用户姓名),用 Map 预加载组装 VO,避免 N+1 也绕开 JOIN 分页陷阱 - 自定义 XML 实现真正联表分页:在 Mapper XML 中手写带
LIMIT的分页 SQL,并单独写一个对应 count SQL(明确指定主表、去重逻辑、JOIN 条件),然后用selectList+selectCount手动封装 Page 对象 - 慎用
searchCount=true在复杂联查中:一旦发现 count 结果异常或超时,第一时间设为 false,改用估算值或分页游标(如 last_id)替代传统页码
分页参数与拦截器配置,守住底线不崩
配置不是摆设,几个关键参数能防止突发流量压垮数据库:
- 设置最大单页条数:
new PaginationInnerInterceptor().setLimit(100),防用户传 pageSize=10000 导致慢查询 - 开启溢出处理:
setOverflow(true),当请求页码超出范围时,自动返回空列表而非报错,提升接口健壮性 - 指定准确 DbType:MySQL 就用
DbType.MYSQL,Oracle 必须用DbType.ORACLE,否则 LIMIT 语法错乱,分页失效 - 避免 Page 对象复用:每次查询必须 new 一个 Page 实例,旧 Page 的 total、records 等属性会被复写,跨线程或循环中复用会导致数据污染
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










