SpringBoot整合Mybatis-Plus实现高效分页查询实战

1. 项目概述在Web应用开发中分页查询是最基础也最常用的功能之一。最近接手一个后台管理系统项目时我发现很多新人对SpringBoot整合Mybatis-Plus实现分页存在不少困惑。本文将分享我在电商平台开发中总结的分页实现方案从配置到实战完整走一遍流程。这个方案的特点是零XML配置完全注解驱动支持前端多种分页参数格式自动处理count查询优化整合Swagger文档展示2. 环境准备与基础配置2.1 依赖引入首先在pom.xml中添加必要依赖以SpringBoot 2.7.x为例dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.2/version /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-extension/artifactId version3.5.2/version /dependency注意避免同时引入mybatis和mybatis-plus的starter可能引起冲突2.2 分页插件配置在SpringBoot启动类或配置类中添加Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 分页插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }这里有几个关键点DbType需根据实际数据库类型设置可以配置maxLimit防止全表查询支持多租户等其它插件组合使用3. 核心实现方案3.1 基础分页查询假设有用户表user对应的Mapper接口public interface UserMapper extends BaseMapperUser { // 无需额外方法 }Service层实现Service public class UserServiceImpl extends ServiceImplUserMapper, User implements UserService { public PageUser pageList(int current, int size) { PageUser page new Page(current, size); return baseMapper.selectPage(page, null); } }Controller示例GetMapping(/users) public RPageUser getUsers( RequestParam(defaultValue 1) int current, RequestParam(defaultValue 10) int size) { return R.success(userService.pageList(current, size)); }3.2 带条件的分页查询实际项目更多需要组合查询条件public PageUser pageQuery(UserQuery query) { LambdaQueryWrapperUser wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.isNotBlank(query.getName()), User::getName, query.getName()) .ge(query.getStartTime() ! null, User::getCreateTime, query.getStartTime()); return baseMapper.selectPage(new Page(query.getCurrent(), query.getSize()), wrapper); }3.3 自定义分页SQL对于复杂SQL可以在Mapper中定义Select(SELECT * FROM user ${ew.customSqlSegment}) PageUser customPage(PageUser page, Param(Constants.WRAPPER) WrapperUser wrapper);4. 高级功能实现4.1 分页参数自动转换创建PageParam类统一接收参数Data public class PageParam { ApiModelProperty(value 页码, example 1) private long current 1; ApiModelProperty(value 每页数量, example 10) private long size 10; ApiModelProperty(排序字段) private String orderBy; ApiModelProperty(是否升序) private Boolean isAsc; public T PageT buildPage() { PageT page new Page(current, size); if (StringUtils.isNotBlank(orderBy)) { if (Boolean.TRUE.equals(isAsc)) { page.addOrder(OrderItem.asc(orderBy)); } else { page.addOrder(OrderItem.desc(orderBy)); } } return page; } }4.2 分页结果统一包装建议统一返回格式Data public class PageResultT implements Serializable { private long current; private long size; private long total; private ListT records; public static T PageResultT success(PageT page) { PageResultT result new PageResult(); result.setCurrent(page.getCurrent()); result.setSize(page.getSize()); result.setTotal(page.getTotal()); result.setRecords(page.getRecords()); return result; } }5. 性能优化技巧5.1 Count查询优化大数据量表count操作很耗性能可以通过以下方式优化使用缓存count结果不查询count设置page.setSearchCount(false)覆盖默认的countSqlSelect(SELECT COUNT(1) FROM user ${ew.customSqlSegment}) Long selectCountCustom(Param(Constants.WRAPPER) WrapperUser wrapper);5.2 多表联查分页推荐两种方案先分页主表ID再联查明细使用子查询分页SELECT * FROM order o WHERE o.id IN ( SELECT id FROM order WHERE user_id #{userId} LIMIT #{offset}, #{size} )6. 常见问题排查6.1 分页失效问题可能原因未配置分页插件方法参数没有Page对象自定义SQL未保留${ew.customSqlSegment}6.2 排序不生效检查点字段名是否正确数据库字段名是否被后续wrapper条件覆盖PageParam中的orderBy是否传递到Page对象6.3 性能问题优化方向检查是否走了正确的索引大数据量考虑游标分页合理设置pageSize建议不超过10007. 最佳实践建议统一分页参数接收格式限制最大pageSize可在拦截器配置重要查询添加分页审计日志前端配合实现优雅的滚动加载导出功能单独处理不分页实际项目中我们还会结合Redis缓存热点数据的分页结果对订单历史等查询采用时间分区等方式优化。Mybatis-Plus的分页功能虽然简单但用好需要结合具体业务场景做适当调整。