企业官网建设流程全解析

告别PageHelper：MyBatis Plus分页插件的高效配置实战

每次看到项目里那些重复的PageHelper配置代码，总让我想起刚入行时被XML分页支配的恐惧。直到遇见MyBatis Plus的PaginationInnerInterceptor，才发现分页原来可以如此优雅。今天我们就来彻底解决这个痛点，用5分钟完成从传统分页到现代分页的华丽转身。

1. 为什么选择MyBatis Plus分页方案

在Spring Boot项目中，分页查询就像空气一样无处不在。传统的PageHelper确实解决了MyBatis原生分页的痛点，但随着项目复杂度提升，它的局限性逐渐显现：

• 侵入性强：需要在每个分页查询前调用PageHelper.startPage()
• 线程安全问题：稍不注意就会导致分页参数泄漏
• 与MyBatis Plus生态割裂：无法充分利用Wrapper条件构造器的优势

相比之下，PaginationInnerInterceptor带来了全新的体验：

// 传统方式 vs MyBatis Plus方式 PageHelper.startPage(1, 10); // Page<User> page = new Page<>(1, 10); List<User> list = userMapper.select(); // userMapper.selectPage(page, queryWrapper);

更关键的是，它与MyBatis Plus的其他组件形成了完美闭环。我们来看几个核心优势对比：

2. 五分钟极简配置指南

让我们从零开始搭建一个Spring Boot项目，体验真正的极简配置。首先确保你的pom.xml已经引入必要依赖：

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

接下来是核心配置类，只需要这20行代码：

@Configuration public class MyBatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 创建分页拦截器并指定数据库类型 PaginationInnerInterceptor paginationInterceptor = new PaginationInnerInterceptor(DbType.MYSQL); // 建议设置的参数（根据实际需求调整） paginationInterceptor.setOverflow(true); // 超出页码返回第一页 paginationInterceptor.setMaxLimit(1000L); // 单页最大记录数 interceptor.addInnerInterceptor(paginationInterceptor); return interceptor; } }

注意：DbType支持多种数据库，包括MySQL、ORACLE、POSTGRE_SQL等，确保选择正确的类型

配置完成后，整个项目就自动获得了分页能力。不需要在每个查询前调用特殊方法，不需要担心线程安全问题，真正的即配即用。

3. 分页查询的实战应用

配置只是开始，真正的魅力在于使用体验。让我们看几个典型场景：

3.1 基础分页查询

// 创建分页参数（当前页，每页大小） Page<User> page = new Page<>(1, 10); // 执行查询（null表示无查询条件） userMapper.selectPage(page, null); // 获取分页数据 List<User> records = page.getRecords(); long total = page.getTotal();

3.2 带条件的分页查询

这才是MyBatis Plus的杀手锏：

// 构建查询条件 LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>(); wrapper.like(User::getName, "张") .gt(User::getAge, 20); // 执行分页查询 Page<User> page = new Page<>(1, 10); userMapper.selectPage(page, wrapper);

3.3 自定义SQL分页

对于复杂SQL，同样支持分页：

<!-- Mapper.xml --> <select id="selectUserPage" resultType="User"> SELECT * FROM user WHERE status = #{status} </select>

// Mapper接口 Page<User> selectUserPage(Page<User> page, @Param("status") Integer status); // 调用方式 Page<User> page = new Page<>(1, 10); userMapper.selectUserPage(page, 1);

4. 高级特性与性能优化

掌握了基础用法后，我们来挖掘一些高阶技巧：

4.1 分页参数调优

// 创建拦截器时设置 paginationInterceptor.setOptimizeJoin(true); // 优化JOIN查询 paginationInterceptor.setDialectClazz(DbType.MYSQL.getDialectClazz()); // 自定义方言 // 运行时动态设置 page.setOptimizeCountSql(false); // 关闭COUNT查询优化 page.setSearchCount(false); // 不查询总记录数

4.2 性能监控建议

当发现分页查询较慢时，可以：

1. 检查是否真正需要select count(1)查询
2. 考虑使用page.setSearchCount(false)跳过总数统计
3. 对于大数据表，考虑使用游标分页替代传统分页

4.3 多租户场景处理

在SAAS系统中，分页需要特别注意：

// 在分页前自动添加租户条件 paginationInterceptor.setTenantLineHandler(new TenantLineHandler() { @Override public Expression getTenantId() { return new LongValue(currentTenantId); } });

5. 常见问题解决方案

在实际项目中踩过几个坑后，总结出这些经验：

问题一：分页总数不准确

解决方案：检查SQL中是否有GROUP BY，这种情况下需要自定义count语句

page.setOptimizeCountSql(false);

问题二：特殊数据库兼容性问题

// 针对达梦数据库的特殊处理 if(databaseType.equals("dm")) { paginationInterceptor.setDialectClazz(DmDialect.class); }

问题三：Page对象序列化问题

// 在DTO中只返回必要字段 @Data public class PageResult<T> { private List<T> records; private long total; public static <T> PageResult<T> of(Page<T> page) { PageResult<T> result = new PageResult<>(); result.setRecords(page.getRecords()); result.setTotal(page.getTotal()); return result; } }

迁移到PaginationInnerInterceptor后，项目中的分页代码量减少了60%，再也不用担心新人忘记调用PageHelper导致的全表查询。最近在微服务项目中全面采用这种方案，配合Feign的Page对象传输，上下游服务的分页交互变得异常简单。