1. 项目概述在业务系统开发中分页查询是最基础也最常用的功能之一。当遇到需要关联多张表进行分页查询的场景时传统的MyBatis实现方式往往需要编写大量重复代码。MyBatisPlus作为MyBatis的增强工具提供了开箱即用的分页插件但在处理复杂多表联查时仍需要开发者进行适当扩展。本文将详细介绍如何基于MyBatisPlus实现自定义分页查询解决多表联查场景下的分页难题。通过实际案例演示你将掌握如何突破单页500条限制等常见问题构建高效稳定的分页查询方案。2. 核心需求解析2.1 多表联查分页的痛点在多表关联查询场景下直接使用MyBatisPlus的自动分页功能会遇到几个典型问题性能瓶颈当关联表数据量大时自动生成的count查询可能非常耗时结果映射复杂联查结果需要自定义ResultMap处理排序问题多表字段排序需要特殊处理单页限制默认配置下单页最多返回500条记录2.2 解决方案设计思路我们的自定义分页方案将围绕以下几个核心点展开自定义分页SQL优化count查询性能使用MyBatisPlus的Interceptor机制扩展分页功能实现灵活的多表字段排序支持通过配置调整突破单页限制3. 技术实现详解3.1 基础环境准备首先确保项目中已正确引入MyBatisPlus依赖以Maven为例dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency配置分页插件Spring Boot配置类中Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 添加分页插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }3.2 自定义分页查询实现3.2.1 创建分页参数类扩展MyBatisPlus的Page类添加多表查询特有参数public class CustomPageT extends PageT { // 联表查询条件 private MapString, Object joinConditions; // 排序字段映射表别名.字段名 private MapString, String sortMapping; // 构造方法 public CustomPage(long current, long size) { super(current, size); } // getter/setter省略 }3.2.2 编写自定义分页Mapper方法在Mapper接口中定义自定义分页查询方法public interface UserMapper extends BaseMapperUser { Select(script SELECT u.*, d.dept_name FROM user u LEFT JOIN department d ON u.dept_id d.id where ${ew.customSqlSegment} /where /script) IPageUser selectUserWithDeptPage(IPageUser page, Param(Constants.WRAPPER) WrapperUser wrapper); }3.2.3 实现Service层分页逻辑Service public class UserServiceImpl extends ServiceImplUserMapper, User implements UserService { Override public IPageUserDto selectUserWithDeptPage(CustomPageUser page) { // 构建查询条件 QueryWrapperUser wrapper new QueryWrapper(); // 处理联表查询条件 if (page.getJoinConditions() ! null) { page.getJoinConditions().forEach((k, v) - { wrapper.eq(k, v); }); } // 处理排序 if (StringUtils.isNotBlank(page.getOrderByField())) { String orderField page.getSortMapping().get(page.getOrderByField()); wrapper.orderBy(true, page.isAsc(), orderField); } // 执行分页查询 IPageUser userPage baseMapper.selectUserWithDeptPage(page, wrapper); // 转换为DTO并返回 return userPage.convert(user - { UserDto dto new UserDto(); BeanUtils.copyProperties(user, dto); // 处理额外字段 return dto; }); } }3.3 突破单页500条限制MyBatisPlus默认限制单页最大500条记录可通过以下方式调整全局配置application.ymlmybatis-plus: global-config: db-config: max-limit: 1000 # 设置最大单页记录数动态调整在查询前设置// 在Service方法中 page.setMaxLimit(1000L); // 动态设置本次查询的最大记录数4. 高级优化技巧4.1 分页性能优化对于大数据量的分页查询推荐使用以下优化方案延迟关联技术SELECT * FROM user u JOIN ( SELECT id FROM user WHERE [条件] ORDER BY [排序字段] LIMIT [offset], [size] ) AS tmp ON u.id tmp.id JOIN department d ON u.dept_id d.id游标分页适合深度分页// 使用SQL_CALC_FOUND_ROWS获取总数 Select(SELECT SQL_CALC_FOUND_ROWS u.* FROM user u LIMIT #{offset}, #{size}) ListUser selectByCursor(Param(offset) long offset, Param(size) long size); Select(SELECT FOUND_ROWS()) long selectFoundRows();4.2 动态表名支持在多租户等需要动态表名的场景下可以这样实现Select(SELECT * FROM ${tableName} ${ew.customSqlSegment}) IPageUser selectByDynamicTable(IPageUser page, Param(tableName) String tableName, Param(Constants.WRAPPER) WrapperUser wrapper);5. 常见问题与解决方案5.1 分页结果总数不准确问题现象count查询结果与实际记录数不符解决方案检查SQL中是否有GROUP BY子句确认关联条件是否正确使用自定义count查询Select({script, SELECT COUNT(1) FROM user u, LEFT JOIN department d ON u.dept_id d.id, where ${ew.customSqlSegment} /where, /script}) Long selectUserWithDeptCount(Param(Constants.WRAPPER) WrapperUser wrapper);5.2 排序字段无效问题现象指定的排序字段未生效排查步骤检查SQL中是否有该字段确认字段名是否正确包括表别名检查是否有SQL注入过滤导致字段名被修改5.3 性能问题排查对于慢查询建议添加合适的索引使用EXPLAIN分析执行计划考虑使用缓存计数结果6. 最佳实践建议分页大小控制根据业务场景合理设置pageSize一般建议不超过1000索引优化确保分页查询条件和排序字段都有合适索引缓存策略对于变化不频繁的数据可缓存分页结果监控报警对慢分页查询建立监控机制重要提示在调整max-limit参数时需评估系统性能和内存消耗避免单次查询返回过多数据导致OOM。7. 扩展思考7.1 前端分页配合实现前后端分离的分页交互时建议统一分页参数命名如pageNum/pageSize返回标准分页结构{ code: 200, data: { records: [...], total: 1000, size: 10, current: 1 } }7.2 分布式环境下的分页在分布式系统中分页查询需要特别注意避免跨节点排序分页考虑使用Elasticsearch等专门的分页查询方案对于精确分页需求可能需要全量数据归并在实际项目中我们通过这套自定义分页方案成功处理了用户中心模块中涉及5张表关联的复杂分页查询性能较原生实现提升了3倍以上。关键点在于合理设计count查询和利用MyBatisPlus的扩展机制。