当前位置：首页 > java >正文

Mybatis 实现分页查询总结

java 2025/8/30 16:48:31

一、原生 SQL 分页

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

xml 实例


<select id="selectUsers" resultType="User">SELECT * FROM usersLIMIT #{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 {@Beanpublic 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();