springboot项目中分页查询的使用示例解析

更新时间：2025年04月28日 09:38:56 作者：coder lei

本文详细讲解SpringBoot中两种主流分页方案：MyBatis+PageHelper和MyBatisPlus的实现方式、原理、优缺点及实际应用场景,内容涵盖配置、代码示例、注意事项和对比总结,感兴趣的朋友一起看看吧

Spring Boot 分页查询详解

本文详细讲解 Spring Boot 中两种主流分页方案：MyBatis + PageHelper 和 MyBatis Plus 的实现方式、原理、优缺点及实际应用场景。内容涵盖配置、代码示例、注意事项和对比总结。

一、分页查询概述

分页查询是 Web 开发中处理大数据集的核心需求，其本质是 按需加载数据，避免一次性返回全部数据导致的性能问题。实现方式通常分为两类：

物理分页：通过 SQL 直接限制查询范围（如 LIMIT）。
逻辑分页：先查询全量数据，再在内存中截取分页（不推荐）。

Spring Boot 中常用 物理分页，依赖 MyBatis 的插件机制动态修改 SQL。

二、MyBatis + PageHelper 分页方案

1. 核心依赖

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.6</version>
</dependency>

2. 配置参数（application.yml）

pagehelper:
  helper-dialect: mysql       # 指定数据库方言（mysql/oracle/postgresql）
  reasonable: true            # 合理化分页参数（超出范围时自动修正）
  support-methods-arguments: true  # 支持接口参数传递分页

3. 分页实现代码

Service 层

public PageInfo<User> getUsersByPage(int pageNum, int pageSize) {
    try {
        // 开启分页：对紧接的第一个查询生效
        PageHelper.startPage(pageNum, pageSize);
        List<User> users = userMapper.selectAll();
        return new PageInfo<>(users);  // 包含总条数、总页数等信息
    } finally {
        PageHelper.clearPage();  // 清理 ThreadLocal
    }
}

Mapper 接口

@Select("SELECT * FROM user WHERE status = 1")
List<User> selectAll();

4. 分页原理

ThreadLocal 传递参数：PageHelper.startPage() 将分页参数存入当前线程的 ThreadLocal。
拦截器重写 SQL：MyBatis 拦截器自动拼接 LIMIT offset, pageSize。
自动执行 COUNT 查询：生成分页数据后，自动查询总记录数。

5. 注意事项

调用顺序：startPage() 必须紧贴查询方法，否则分页不生效。
线程安全：异步或多线程场景需手动传递分页参数。
性能优化：复杂 SQL 可自定义 COUNT 查询：

@Select("SELECT COUNT(*) FROM user WHERE status = 1")
Long countUsers();
// 指定自定义 COUNT 方法
PageHelper.startPage(1, 10).count(true).setCountSql("countUsers");

三、MyBatis Plus 分页方案

1. 核心依赖

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

2. 分页插件配置

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加分页拦截器，指定数据库类型
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

3. 分页实现代码

Service 层

public IPage<User> getUsersByPage(int pageNum, int pageSize) {
    // 创建分页对象
    Page<User> page = new Page<>(pageNum, pageSize);
    // 执行分页查询（自动处理 SQL）
    return userMapper.selectPage(page, new QueryWrapper<User>().eq("status", 1));
}

Mapper 接口

public interface UserMapper extends BaseMapper<User> {
    // 继承 BaseMapper 默认提供分页方法
}

4. 分页原理

内置分页拦截器：自动识别 IPage 参数，重写 SQL。
统一分页模型：通过 IPage<T> 接口封装分页参数和结果。
多数据库支持：根据 DbType 生成不同分页 SQL（如 Oracle 的 ROWNUM）。

5. 注意事项

Wrapper 条件：分页需结合 QueryWrapper 或自定义 SQL。
性能优化：大数据量分页需手动优化 COUNT 查询：

// 关闭自动 COUNT 查询
Page<User> page = new Page<>(pageNum, pageSize, false);
List<User> users = userMapper.selectPage(page, wrapper);
// 手动执行 COUNT 查询
page.setTotal(userMapper.selectCount(wrapper));

四、对比总结

对比维度	MyBatis + PageHelper	MyBatis Plus
依赖复杂度	仅需 PageHelper 依赖	需引入 MyBatis Plus 全家桶
配置难度	需配置方言、合理化参数	仅需定义分页拦截器
侵入性	低（无需修改 Mapper）	高（需继承 `BaseMapper`）
SQL 灵活性	支持任意复杂 SQL，手动优化空间大	简单查询高效，复杂 SQL 需自定义
线程安全	依赖 `ThreadLocal`，需注意异步场景	无线程安全问题（参数传递）
适用场景	已有 MyBatis 项目，需灵活分页	新项目或深度集成 MyBatis Plus

五、最佳实践与常见问题

1. 最佳实践

简单分页：优先使用 MyBatis Plus，减少代码量。
复杂 SQL：选择 PageHelper，灵活控制 SQL。
性能优化：
- 添加索引（如 CREATE INDEX idx_status ON user(status)）。
- 避免 SELECT *，仅查询必要字段。
- 大数据量分页使用 游标分页 或 延迟关联。

2. 常见问题

Q1：分页不生效

原因：startPage() 调用顺序错误或未配置拦截器。
解决：确保 startPage() 在查询方法前调用，检查依赖和配置。

Q2：总条数（total）为 0

原因：COUNT 查询未匹配条件或 SQL 错误。
解决：手动指定 COUNT 方法或检查查询条件。

Q3：性能低下

优化：

-- 原始 SQL（性能差）
SELECT * FROM orders ORDER BY id LIMIT 1000000, 10;
-- 优化 SQL（延迟关联）
SELECT * FROM orders 
WHERE id >= (SELECT id FROM orders ORDER BY id LIMIT 1000000, 1)
ORDER BY id LIMIT 10;

六、附录：完整代码示例

PageHelper 完整示例

// Service
public PageInfo<User> getUsers(int pageNum, int pageSize) {
    try {
        PageHelper.startPage(pageNum, pageSize);
        List<User> users = userMapper.selectByCondition("active");
        return new PageInfo<>(users);
    } finally {
        PageHelper.clearPage();
    }
}
// Mapper
@Select("SELECT * FROM user WHERE status = #{status}")
List<User> selectByCondition(String status);

MyBatis Plus 完整示例

// Service
public IPage<User> getUsers(int pageNum, int pageSize) {
    Page<User> page = new Page<>(pageNum, pageSize);
    QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.eq("status", "active");
    return userMapper.selectPage(page, wrapper);
}

到此这篇关于springboot项目中分页查询的使用解析的文章就介绍到这了,更多相关springboot分页查询使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java数组模拟优先级队列数据结构的实例
这篇文章主要介绍了Java数组模拟优先级队列数据结构的实例,优先级队列中的元素会被设置优先权,本文的例子借助了Java中的TreeSet和TreeMap,需要的朋友可以参考下
2016-04-04
IDEA Spring Boot 自动化构建+部署的实现
这篇文章主要介绍了IDEA Spring Boot 自动化构建+部署的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-01-01
Java设计模式之观察者模式observer pattern详解
这篇文章主要介绍了Java设计模式之观察者模式observer pattern详解,当一个对象发生数据变化时,通知其他相关的一系列对象,接受到通知的对象根据该对象的变化进行相应处理以响应变化的过程,需要的朋友可以参考下
2023-12-12
详解Java利用深度优先遍历解决迷宫问题
深度优先遍历：深度优先遍历是图论中的经典算法。其利用了深度优先搜索算法可以产生目标图的相应拓扑排序表，采用拓扑排序表可以解决很多相关的图论问题，如最大路径问题等等。本文将利用深度优先遍历解决迷宫问题，感兴趣的可以了解一下
2022-02-02
SpringBoot实现邮件发送的完整解决方案(附件发送、内嵌图片与中文乱码处理)
本文基于 Spring Boot 2.x + JDK 1.8 + Jakarta Mail 1.6.2,提供生产环境可用的完整邮件发送解决方案,涵盖附件发送、内嵌图片、中文乱码处理等核心场景,需要的朋友可以参考下
2026-02-02
Mybatis-Plus之ID自动增长的设置实现
本文主要介绍了Mybatis-Plus之ID自动增长的设置实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-07-07
SpringBoot整合FastDFS方法过程详解
这篇文章主要介绍了SpringBoot整合FastDFS方法过程详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-05-05
Java等待唤醒机制原理实例解析
这篇文章主要介绍了Java等待唤醒机制原理实例解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
Java使用Ajax实现跨域上传图片功能
这篇文章主要介绍了Java使用Ajax实现跨域上传图片功能,需要的朋友可以参考下
2017-09-09
基于Java实现简单的邮件群发功能
这篇文章主要为大家详细介绍了如何利用Java语言编写一个简单的工具类，可以实现邮件群发功能。文中的示例代码讲解详细，需要的可以参考一下
2022-05-05