java分页插件| MyBatis-Plus分页 vs PageHelper分页：全面对比与最佳实践

MyBatis-Plus分页 vs PageHelper分页：全面对比与最佳实践

一、分页技术概述

在Java持久层框架中，分页是高频使用的功能。主流方案有：

MyBatis-Plus分页：MyBatis增强工具的内置分页方案
PageHelper分页：独立的MyBatis分页插件

二、核心相同点

✅ 基础功能一致：

都支持物理分页（LIMIT语句）
都能返回分页元数据（当前页、总页数等）
都基于MyBatis拦截器实现

✅ 开发体验：

都只需少量代码即可实现分页
都支持主流关系型数据库

三、关键差异对比

特性	MyBatis-Plus分页	PageHelper分页
依赖关系	需集成MyBatis-Plus	独立jar包
分页启动方式	构造Page对象传参	ThreadLocal静态方法
返回值	IPage接口对象	PageInfo包装List
复杂SQL支持	有限制（如嵌套查询可能失效）	支持更复杂SQL场景
多数据源支持	需要特殊配置	天然支持
COUNT查询	自动执行（可关闭）	自动执行（可关闭）
与ORM集成	深度集成条件构造器	兼容任何MyBatis用法

四、使用指南

1. MyBatis-Plus分页使用

① 配置拦截器

java 复制代码

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

五、实战案例

案例1：多表联合分页查询（推荐PageHelper）

java 复制代码

// 使用PageHelper
public PageInfo<UserVO> getUsersWithDepartment(int pageNum) {
    PageHelper.startPage(pageNum, 10);
    List<UserVO> list = userMapper.selectUsersWithDept();
    return new PageInfo<>(list);
}

// SQL示例
@Select("SELECT u.*, d.dept_name FROM user u LEFT JOIN department d ON u.dept_id = d.id")
List<UserVO> selectUsersWithDept();

案例2：条件构造器分页（推荐MyBatis-Plus）

java 复制代码

public IPage<User> searchUsers(String keyword, int pageNum) {
    LambdaQueryWrapper<User> wrapper = Wrappers.lambdaQuery();
    wrapper.like(User::getName, keyword);
    
    Page<User> page = new Page<>(pageNum, 10);
    return userMapper.selectPage(page, wrapper);
}

六、性能优化建议

1.关闭COUNT查询（大数据量时）

java 复制代码

// MyBatis-Plus
Page<User> page = new Page<>(pageNum, size, false);

// PageHelper
PageHelper.startPage(pageNum, size, false);

2.特殊语法支持

java 复制代码

// PageHelper对特殊语法更友好
PageHelper.startPage(1, 10).setCount(false);
List<Map<String,Object>> list = starrocksMapper.complexQuery();

3.索引优化
4.确保分页字段有索引
5.带排序时建立复合索引

七、技术选型推荐

👉 推荐MyBatis-Plus分页

当：

项目已集成MyBatis-Plus

需要与条件构造器配合使用

使用标准SQL语法

需要强类型分页对象

👉 推荐PageHelper

当：

需要兼容原生MyBatis

涉及复杂SQL（嵌套/UNION等）

使用StarRocks等特殊数据库

需要快速集成多数据源

八、常见问题解答

Q：为什么PageHelper对复杂SQL支持更好？

A：PageHelper采用更"粗放"的拦截方式，不会深度解析SQL，而MyBatis-Plus的拦截器会尝试智能分析SQL结构。

Q：百万数据量如何优化？

使用游标分页（基于排序字段）

禁用COUNT查询

添加合适的索引

📌 最佳实践总结：新项目建议统一使用MyBatis-Plus分页，遗留系统或特殊需求使用PageHelper。无论哪种方案，都应关注分页性能，避免全表扫描