基于MyBatis-Plus的高效分页查询实现指南

一、MyBatis-Plus分页功能概述

MyBatis-Plus作为MyBatis的增强工具，在保留原生MyBatis特性的基础上，通过内置分页插件简化了分页查询的实现流程。其核心优势在于：

1. 零侵入设计：无需修改原有Mapper接口即可实现分页
2. SQL自动优化：自动生成COUNT查询语句，避免手动编写
3. 多数据库支持：兼容MySQL、Oracle、PostgreSQL等主流数据库
4. 高性能实现：采用物理分页而非内存分页，避免大数据量下的性能损耗

分页功能主要解决两类业务场景：

• 前端展示分页数据（如每页10条记录）
• 批量处理时的分批次操作（如百万级数据导出）

二、分页插件配置详解

2.1 基础配置步骤

1. 添加依赖（Maven项目）：

   <dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>最新版本</version>
   </dependency>

2. 配置分页插件（Spring Boot环境）：

   @Configuration
   public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
   }

2.2 高级配置选项

配置项	类型	默认值	说明
maxLimit	Long	-1	单页最大限制，-1表示不限制
overflow	Boolean	false	超过maxLimit时是否修正
dbType	DbType	无	数据库类型枚举

示例：限制单页最多500条记录

interceptor.addInnerInterceptor(
    new PaginationInnerInterceptor(DbType.MYSQL)
        .setMaxLimit(500L)
        .setOverflow(true)
);

三、分页查询实现方式

3.1 基本分页查询

// 1. 创建分页对象
Page<User> page = new Page<>(1, 10); // 当前页，每页大小
// 2. 执行分页查询
IPage<User> userPage = userMapper.selectPage(page, null);
// 3. 获取结果
List<User> records = userPage.getRecords(); // 当前页数据
long total = userPage.getTotal();           // 总记录数
long pages = userPage.getPages();           // 总页数

3.2 条件分页查询

结合Wrapper实现条件过滤：

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("status", 1)
       .like("name", "张");
Page<User> page = new Page<>(2, 5);
IPage<User> result = userMapper.selectPage(page, wrapper);

3.3 自定义SQL分页

对于复杂查询，可在XML中直接使用<page/>标签：

<select id="selectCustomPage" resultType="User">
    SELECT * FROM user 
    WHERE age > #{age}
    <page/>
</select>

Java调用方式：

Page<User> page = new Page<>(1, 8);
page.addParam("age", 18);
IPage<User> result = userMapper.selectCustomPage(page);

四、性能优化策略

4.1 索引优化

1. 分页字段索引：确保ORDER BY涉及的字段有索引
2. 覆盖索引：查询字段应包含在索引中
3. 避免全表扫描：WHERE条件应使用索引列

4.2 深度分页优化

当页码过大时（如第10000页），采用子查询优化：

// 方案1：使用子查询（推荐）
Page<User> page = new Page<>(10000, 10);
wrapper.apply("id > (select id from user order by id limit {0},1)", 
    (page.getCurrent()-1)*page.getSize());
// 方案2：使用游标分页（适用于有序ID）
Long lastId = ...; // 上一页最后一条记录的ID
wrapper.gt("id", lastId).orderByAsc("id");

4.3 缓存策略

1. 结果缓存：对不常变动的数据启用二级缓存
2. COUNT缓存：对固定条件的总记录数进行缓存
3. 分页预取：提前加载相邻页数据

五、常见问题解决方案

5.1 分页总数不准确

原因：

• 事务未提交导致COUNT查询结果不一致
• 动态表名导致SQL解析错误

解决方案：

// 强制事务提交后再查询
@Transactional(propagation = Propagation.REQUIRES_NEW)
public IPage<User> getAccuratePage() {
    // 业务操作
    return userMapper.selectPage(new Page<>(1,10), null);
}

5.2 多表关联分页

推荐方案：

1. 先分页后关联（适用于关联表数据量少）：

   Page<User> page = new Page<>(1,10);
   IPage<User> userPage = userMapper.selectPage(page, null);
   userPage.getRecords().forEach(user -> {
    // 手动关联查询
    List<Order> orders = orderMapper.selectByUserId(user.getId());
    user.setOrders(orders);
   });

2. 使用子查询（适用于大数据量）：

   SELECT u.*, o.order_count 
   FROM (
    SELECT * FROM user LIMIT 0,10
   ) u 
   LEFT JOIN (
    SELECT user_id, COUNT(*) as order_count 
    FROM orders GROUP BY user_id
   ) o ON u.id = o.user_id

5.3 分布式分页

解决方案：

1. 全局ID方案：使用雪花算法等生成有序ID
2. 中间表方案：建立数据分片索引表
3. Elasticsearch方案：将数据同步到ES进行分页查询

六、最佳实践建议

1. 分页大小选择：

   • Web端：10-20条/页
   • 后台管理：20-50条/页
   • 批量处理：500-1000条/页

2. 默认分页参数：

   // 在BaseMapper中定义默认分页方法
   public interface BaseMapper<T> extends com.baomidou.mybatisplus.core.mapper.BaseMapper<T> {
    default IPage<T> selectPageDefault(Page<T> page) {
        if (page.getSize() > 500) {
            page.setSize(500);
        }
        return this.selectPage(page, null);
    }
   }

3. 分页查询监控：

   // 实现PerformanceInterceptor监控SQL执行
   @Bean
   public PerformanceInterceptor performanceInterceptor() {
    PerformanceInterceptor interceptor = new PerformanceInterceptor();
    interceptor.setFormat(true);
    interceptor.setMaxTime(1000); // SQL执行最大时间(ms)
    return interceptor;
   }

七、版本兼容说明

MyBatis-Plus版本	最低MyBatis版本	最低Spring Boot版本
3.5.0+	3.5.6	2.1.x
3.4.x	3.5.3	2.0.x
3.3.x	3.5.1	1.5.x

升级注意事项：

1. 3.4.0版本开始废弃PaginationInterceptor，改用MybatisPlusInterceptor
2. 3.5.0版本优化了COUNT查询的缓存机制
3. 跨版本升级时建议先进行功能测试

八、总结与展望

MyBatis-Plus的分页功能通过插件化设计实现了开箱即用的分页能力，其核心价值在于：

1. 显著降低分页实现成本
2. 保持SQL的可控性和可优化性
3. 提供统一的分页接口规范

未来发展趋势：

1. 与Spring Data整合提供更统一的分页API
2. 增强对NoSQL数据库的分页支持
3. 引入AI预测分页优化策略

建议开发者在使用过程中：

1. 合理设置分页大小上限
2. 对深度分页场景进行特别优化
3. 定期监控分页查询性能
4. 保持MyBatis-Plus版本更新以获取最新优化

通过规范使用MyBatis-Plus的分页功能，可以有效提升开发效率，同时保证系统的性能和稳定性。在实际项目中，建议结合具体业务场景选择最适合的分页实现方案。