基于Mybatis-plus分页查询功能的实现

一、分页查询技术背景与MyBatis-Plus优势

在Web应用开发中，分页查询是处理大数据集的核心功能。传统MyBatis实现需手动编写分页SQL，存在以下痛点：

1. 重复编写COUNT查询语句
2. 手动计算偏移量易出错
3. 性能优化困难
4. 跨数据库方言兼容问题

MyBatis-Plus作为MyBatis的增强工具，通过内置分页插件解决了这些问题。其核心优势包括：

• 自动化COUNT查询生成
• 统一API接口
• 数据库方言自动适配
• 拦截器机制实现无侵入式分页

二、核心组件解析与配置

1. 分页插件配置

MyBatis-Plus 3.x版本推荐使用MybatisPlusInterceptor进行配置：

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

关键配置项说明：

• DbType：指定数据库类型（MySQL/Oracle/PostgreSQL等）
• maxLimit：单页最大记录数限制（防全表扫描）
• overflow：页码溢出处理策略

2. 分页参数对象

Page类是分页查询的核心参数对象，包含三个核心属性：

// 当前页码（从1开始）
private long current;
// 每页显示条数
private long size;
// 排序条件（可多字段）
private List<OrderItem> orders;
// 自动计算的总页数
private transient Long pages;
// 查询总数
private transient Long total;
// 结果集
private transient List<T> records;

三、基础分页查询实现

1. Service层实现

标准分页查询方法示例：

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    @Override
    public Page<User> queryUserPage(Page<User> page, String name) {
        // 构造查询条件
        QueryWrapper<User> wrapper = new QueryWrapper<>();
        wrapper.like("name", name);
        // 执行分页查询
        return baseMapper.selectPage(page, wrapper);
    }
}

2. Controller层实现

RESTful接口实现示例：

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;
    @GetMapping("/page")
    public Result<Page<User>> getUserPage(
            @RequestParam(defaultValue = "1") Long current,
            @RequestParam(defaultValue = "10") Long size,
            @RequestParam(required = false) String name) {
        Page<User> page = new Page<>(current, size);
        Page<User> userPage = userService.queryUserPage(page, name);
        return Result.success(userPage);
    }
}

四、高级功能实现

1. 多表关联分页查询

对于关联查询场景，建议采用两种方案：

1. 子查询分页（推荐）：

   public Page<UserVO> queryUserWithRolePage(Page<UserVO> page, String keyword) {
    // 先执行分页查询
    Page<User> userPage = baseMapper.selectPage(page, 
        new QueryWrapper<User>().like("username", keyword));
    // 再处理关联数据（示例伪代码）
    List<UserVO> vos = userPage.getRecords().stream()
        .map(user -> {
            UserVO vo = new UserVO();
            BeanUtils.copyProperties(user, vo);
            Role role = roleService.getByUserId(user.getId());
            vo.setRoleName(role.getName());
            return vo;
        }).collect(Collectors.toList());
    return new Page<>(userPage.getCurrent(), userPage.getSize(), 
                     userPage.getTotal(), vos);
   }

2. 使用SQL JOIN（需注意性能）：

   @Select("SELECT u.*, r.name as roleName FROM user u LEFT JOIN role r ON u.role_id=r.id ${ew.customSqlSegment}")
   Page<Map<String, Object>> selectUserWithRole(Page<User> page, @Param(Constants.WRAPPER) Wrapper<User> wrapper);

2. 自定义SQL分页

对于复杂查询场景，可通过XML映射文件实现：

<select id="selectCustomPage" resultType="map">
    SELECT * FROM (
        SELECT a.*, ROW_NUMBER() OVER (ORDER BY ${ew.sqlSort}) as row_num
        FROM user a
        ${ew.customSqlSegment}
    ) temp
    WHERE row_num BETWEEN #{page.current}*#{page.size}-#{page.size}+1 
                      AND #{page.current}*#{page.size}
</select>

五、性能优化策略

1. 计数查询优化

• 缓存计数结果：对静态数据可缓存总记录数
• 近似计数：对大数据表可使用EXPLAIN估算行数
• 延迟计数：先返回分页数据，异步加载总数

2. 数据库层面优化

• 为分页字段建立索引
• 避免ORDER BY大字段
• 对Oracle等数据库使用ROWNUM优化

3. 前端交互优化

• 无限滚动加载替代传统分页
• 记忆用户分页偏好
• 预加载下一页数据

六、常见问题解决方案

1. 分页结果不准确问题

现象：总记录数与实际结果不符
原因：

• 自定义SQL中的条件未同步到COUNT查询
• 多表关联导致重复计数
  解决方案：

  // 使用selectCount方法显式指定计数SQL
  wrapper.select("DISTINCT user_id"); // 去重
  long count = baseMapper.selectCount(wrapper);

2. 性能瓶颈分析

诊断工具：

• MyBatis-Plus内置日志
• 数据库慢查询日志
• JProfiler等性能分析工具

优化案例：

// 优化前（全表扫描）
wrapper.eq("status", 1).orderByDesc("create_time");
// 优化后（索引利用）
wrapper.eq("status", 1)
       .last("ORDER BY create_time DESC LIMIT 1000000,10"); // 深度分页优化

七、最佳实践建议

1. 分页大小设计：

   • 移动端建议10-20条/页
   • 管理后台建议20-50条/页
   • 报表类应用可配置为100-500条/页

2. 安全防护：

   // 限制最大分页大小
   public Page<User> safeQuery(Page<User> page) {
       if (page.getSize() > 100) {
           page.setSize(100);
       }
       return baseMapper.selectPage(page, null);
   }

3. 测试用例设计：

   • 边界值测试（第1页、最后页）
   • 异常值测试（0页、负页码）
   • 性能测试（大数据量分页）

八、版本兼容性说明

MyBatis-Plus版本	分页插件变化	注意事项
3.0.x	新增拦截器机制	需移除旧版分页插件配置
3.4.x	优化COUNT查询	支持多数据源分页
3.5.x	性能提升20%	推荐使用最新稳定版

九、扩展功能探索

1. 动态表分页：

   public interface DynamicTableMapper {
    @Select("SELECT * FROM ${tableName} ${ew.customSqlSegment}")
    Page<Map<String, Object>> selectByTable(Page<?> page, 
                                          @Param("tableName") String tableName,
                                          @Param(Constants.WRAPPER) Wrapper<?> wrapper);
   }

2. 多租户分页：

   @Bean
   public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() {
        @Override
        public Expression getTenantId() {
            return new LongValue(1L); // 租户ID
        }
        @Override
        public String getTenantIdColumn() {
            return "tenant_id";
        }
    }));
    interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
    return interceptor;
   }

十、总结与展望

MyBatis-Plus分页功能通过拦截器机制实现了优雅的分页解决方案，其核心价值体现在：

1. 开发效率提升：减少80%的分页代码量
2. 维护成本降低：统一分页逻辑处理
3. 性能优化空间：提供多种优化手段

未来发展方向可能包括：

• AI驱动的智能分页大小推荐
• 跨数据库分页策略自动适配
• 与Spring Data的深度集成

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

1. 合理设置分页大小阈值
2. 对深度分页场景采用游标或延迟加载
3. 定期检查分页SQL执行计划

通过掌握本文介绍的技术要点和最佳实践，开发者可以高效实现稳定可靠的分页查询功能，为系统性能优化和用户体验提升奠定坚实基础。