Mybatis 实现分页查询总结

一、原生 SQL 分页

原理：直接在 SQL语句 中编写数据库特定的分页语法（如 MySQL 的 LIMIT、Oracle 的 ROWNUM）

xml 实例

<select id="selectUsers" resultType="User">
  SELECT * FROM users
  LIMIT #{offset}, #{pageSize}
</select>

优点：

1、性能最优，直接通过数据库物理分页，仅查询所需数据
2、无额外依赖，适用于简单场景

缺点：

1、SQL 与数据库类型绑定，切换数据库需修改 SQL
2、需要手动计算分页参数（offset、pageSize）

二、RowBounds 分页（逻辑分页）

原理：通过 MyBatis 的 RowBounds 对象实现内存分页（逻辑分页）。查询时会获取全部数据，但在内存中截取指定范围。

List<User> users = sqlSession.selectList("selectUsers", null, new RowBounds(offset, pageSize));

优点：

1、代码简单，无需修改 SQL
2、兼容所有数据库

缺点：

1、​性能差：数据量大时会导致内存溢出或查询缓慢（需全量加载数据）
2、仅适用于小数据集

三、PageHelper 插件（推荐）

原理：通过拦截器动态修改 SQL，自动添加分页语句（物理分页）。支持多种数据库，并封装分页结果（总条数、页码等）

依赖：

<dependency>
  <groupId>com.github.pagehelper</groupId>
  <artifactId>pagehelper</artifactId>
  <version>5.3.0</version>
</dependency>

配置拦截器​（MyBatis 配置文件中）：

<plugins>
  <plugin interceptor="com.github.pagehelper.PageInterceptor">
    <property name="helperDialect" value="mysql"/> <!-- 指定数据库类型 -->
  </plugin>
</plugins>

代码调用

// 开启分页
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.selectUsers();
// 封装分页结果
PageInfo<User> pageInfo = new PageInfo<>(users);

优点：

1、自动适配不同数据库的分页语法（如 MySQL、Oracle、PostgreSQL）
2、提供 PageInfo 对象，包含总记录数、总页数、当前页等分页信息
3、对代码侵入性低

缺点：

1、需要引入第三方依赖

四、MyBatis-Plus 分页插件

原理：MyBatis-Plus 是 MyBatis 的增强工具，内置分页插件，通过拦截器实现物理分页

依赖：

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
  <version>3.5.3.1</version>
</dependency>

配置分页插件

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

代码调用

// 创建分页参数
Page<User> page = new Page<>(pageNum, pageSize);
// 执行分页查询
Page<User> result = userMapper.selectPage(page, null);
// 获取分页信息
long total = result.getTotal();
List<User> users = result.getRecords();

优点：

1、与 MyBatis-Plus 深度集成，支持更丰富的 CRUD 操作
2、自动处理分页逻辑，返回包含分页信息的 Page 对象

五、总结

优先使用 ​PageHelper 或 ​MyBatis-Plus 分页插件，二者均通过物理分页实现高性能，且对代码侵入性低，它们能自动适配不同数据库的分页语法。