最完整MyBatis 3分页查询方案：从基础到高级的性能优化指南

最完整MyBatis 3分页查询方案：从基础到高级的性能优化指南

【免费下载链接】mybatis-3 MyBatis SQL mapper framework for Java 项目地址: https://gitcode.com/gh_mirrors/my/mybatis-3

你是否还在为MyBatis分页查询的性能问题烦恼？是否遇到过"越往后翻页查询越慢"的情况？本文将系统对比4种MyBatis分页实现方案，帮你解决90%的分页难题，让你轻松应对百万级数据查询场景。

读完本文你将获得：

• 掌握RowBounds、拦截器、插件和SQL构建器4种分页方案的实现
• 学会根据数据量和业务场景选择最优分页策略
• 了解分页查询的性能优化技巧和最佳实践
• 避免常见的分页陷阱和错误用法

分页查询的重要性与挑战

在现代Web应用中，分页查询是必不可少的功能。当数据量达到成千上万条时，一次性加载所有数据会导致严重的性能问题：内存占用过高、网络传输缓慢、页面加载延迟等。MyBatis作为一款优秀的ORM框架，提供了多种分页解决方案，但选择合适的方案需要对各种实现的原理和优缺点有深入了解。

MyBatis的分页实现主要分为两大类：逻辑分页和物理分页。逻辑分页是在内存中进行分页，通过查询所有数据后再截取所需部分；物理分页则是通过数据库的分页语句直接获取指定范围的数据。这两种方式各有适用场景，我们将在后续章节详细对比。

方案一：基础RowBounds分页（逻辑分页）

实现原理与代码示例

RowBounds是MyBatis提供的最基础分页方式，它通过在查询时指定offset和limit参数来实现分页。这种方式的本质是查询所有符合条件的数据，然后在内存中截取所需的部分，属于逻辑分页。

使用RowBounds非常简单，只需在Mapper接口方法中添加RowBounds参数：

List<Blog> selectBlogs(RowBounds rowBounds);

在调用时传入RowBounds实例：

int offset = 10; // 起始位置
int limit = 5;  // 每页条数
RowBounds rowBounds = new RowBounds(offset, limit);
List<Blog> blogs = blogMapper.selectBlogs(rowBounds);

对应的XML映射文件无需特殊处理：

<select id="selectBlogs" resultType="Blog">
  SELECT * FROM BLOG
</select>

优缺点分析

优点：

• 实现简单，无需额外配置
• 适用于任何数据库，不依赖数据库特性
• 代码侵入性低，只需修改方法参数

缺点：

• 性能问题：会查询所有符合条件的数据，然后在内存中分页
• 内存占用大：当数据量大时，可能导致内存溢出
• 不适合大数据量场景：数据量越大，性能越差

适用场景

RowBounds适合数据量较小（如几百条以内）的简单分页场景，或者作为临时解决方案。对于大数据量查询，不建议使用这种方式。

MyBatis的RowBounds实现类位于src/main/java/org/apache/ibatis/session/RowBounds.java，核心代码如下：

public class RowBounds {
  public static final int NO_ROW_OFFSET = 0;
  public static final int NO_ROW_LIMIT = Integer.MAX_VALUE;
  public static final RowBounds DEFAULT = new RowBounds();

  private final int offset;
  private final int limit;

  public RowBounds() {
    this.offset = NO_ROW_OFFSET;
    this.limit = NO_ROW_LIMIT;
  }

  public RowBounds(int offset, int limit) {
    this.offset = offset;
    this.limit = limit;
  }

  // getter方法省略
}

方案二：拦截器分页（物理分页）

实现原理与代码示例

拦截器分页是通过MyBatis的插件机制，在SQL执行前动态添加分页语句，从而实现物理分页。这种方式的优点是对业务代码侵入小，且能利用数据库的分页功能提高查询效率。

首先，创建一个分页拦截器：

@Component
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})})
public class PageInterceptor implements Interceptor {
  @Override
  public Object intercept(Invocation invocation) throws Throwable {
    // 获取StatementHandler
    StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
    MetaObject metaObject = SystemMetaObject.forObject(statementHandler);
    
    // 获取参数信息
    BoundSql boundSql = (BoundSql) metaObject.getValue("delegate.boundSql");
    Object parameterObject = boundSql.getParameterObject();
    
    // 判断是否包含分页参数
    if (parameterObject instanceof PageParam) {
      PageParam pageParam = (PageParam) parameterObject;
      int pageNum = pageParam.getPageNum();
      int pageSize = pageParam.getPageSize();
      
      if (pageNum > 0 && pageSize > 0) {
        // 获取原始SQL
        String sql = boundSql.getSql();
        // 生成分页SQL（以MySQL为例）
        String pageSql = sql + " LIMIT " + (pageNum - 1) * pageSize + ", " + pageSize;
        // 设置分页SQL
        metaObject.setValue("delegate.boundSql.sql", pageSql);
        
        // 清除参数中的分页信息，避免参数不匹配
        metaObject.setValue("delegate.boundSql.parameterObject", pageParam.getParam());
      }
    }
    
    return invocation.proceed();
  }
  
  @Override
  public Object plugin(Object target) {
    return Plugin.wrap(target, this);
  }
  
  @Override
  public void setProperties(Properties properties) {
    // 可以通过properties配置分页参数
  }
}

然后在MyBatis配置文件中注册拦截器：

<plugins>
  <plugin interceptor="com.example.PageInterceptor">
    <!-- 可以配置拦截器属性 -->
  </plugin>
</plugins>

优缺点分析

优点：

• 真正的物理分页，性能好
• 对业务代码侵入小，只需定义分页参数
• 可灵活适配不同数据库

缺点：

• 实现相对复杂，需要了解MyBatis拦截器原理
• 需要处理不同数据库的分页语法差异
• 可能与其他拦截器产生冲突

适用场景

拦截器分页适用于大多数需要物理分页的场景，特别是当项目中没有使用分页插件，或者需要自定义分页逻辑时。这种方式性能较好，且灵活性高。

MyBatis的拦截器相关类位于src/main/java/org/apache/ibatis/plugin/目录，包括Interceptor接口、Plugin类等。

方案三：PageHelper分页插件（物理分页）

实现原理与代码示例

PageHelper是MyBatis最流行的分页插件之一，它基于拦截器实现，提供了非常便捷的分页功能。使用PageHelper可以在不修改SQL的情况下实现物理分页。

首先需要在项目中引入PageHelper依赖（以Maven为例）：

<dependency>
  <groupId>com.github.pagehelper</groupId>
  <artifactId>pagehelper</artifactId>
  <version>最新版本</version>
</dependency>

然后在MyBatis配置文件中配置插件：

<plugins>
  <plugin interceptor="com.github.pagehelper.PageInterceptor">
    <!-- 配置数据库方言 -->
    <property name="helperDialect" value="mysql"/>
    <!-- 分页合理化 -->
    <property name="reasonable" value="true"/>
  </plugin>
</plugins>

使用方式非常简单，只需在查询前调用PageHelper.startPage方法：

// 设置分页参数，第1页，每页10条
PageHelper.startPage(1, 10);
// 后续的第一个查询会自动分页
List<Blog> blogs = blogMapper.selectBlogs();
// 获取分页信息
PageInfo<Blog> pageInfo = new PageInfo<>(blogs);
System.out.println("总页数：" + pageInfo.getPages());
System.out.println("总记录数：" + pageInfo.getTotal());

Mapper接口和XML映射文件无需任何特殊处理：

List<Blog> selectBlogs();

<select id="selectBlogs" resultType="Blog">
  SELECT * FROM BLOG
</select>

优缺点分析

优点：

• 使用极其简单，一行代码实现分页
• 功能强大，支持多种数据库和复杂查询
• 提供丰富的分页相关信息
• 社区活跃，问题解决及时

缺点：

• 需要引入第三方依赖
• 对分页原理不了解时，容易出现问题
• 某些复杂场景可能需要特殊处理

适用场景

PageHelper几乎适用于所有需要物理分页的场景，特别是在快速开发和对分页功能有较高要求的项目中。它的易用性和强大功能使其成为MyBatis分页的首选方案。

方案四：动态SQL分页（物理分页）

实现原理与代码示例

动态SQL分页是通过在SQL语句中直接编写分页逻辑来实现物理分页。这种方式需要手动在SQL中添加分页条件，但可以精确控制分页逻辑。

MyBatis提供了多种动态SQL标签，可以用来构建分页查询。例如，使用if标签判断是否添加分页条件：

<select id="selectBlogsByPage" resultType="Blog">
  SELECT * FROM BLOG
  <where>
    <if test="title != null">
      AND title LIKE CONCAT('%', #{title}, '%')
    </if>
  </where>
  ORDER BY create_time DESC
  <if test="pageNum != null and pageSize != null">
    LIMIT #{offset}, #{pageSize}
  </if>
</select>

对应的Mapper接口方法：

List<Blog> selectBlogsByPage(@Param("title") String title, 
                            @Param("offset") int offset, 
                            @Param("pageSize") int pageSize);

调用时需要计算offset：

int pageNum = 1;
int pageSize = 10;
int offset = (pageNum - 1) * pageSize;
List<Blog> blogs = blogMapper.selectBlogsByPage("MyBatis", offset, pageSize);

除了直接使用LIMIT，还可以使用MyBatis的bind标签来优化：

<select id="selectBlogsByPage" resultType="Blog">
  <bind name="offset" value="(pageNum - 1) * pageSize"/>
  SELECT * FROM BLOG
  ORDER BY create_time DESC
  LIMIT #{offset}, #{pageSize}
</select>

对于需要查询总记录数的场景，可以单独编写一个查询总数的方法：

<select id="selectBlogsCount" resultType="int">
  SELECT COUNT(*) FROM BLOG
  <where>
    <if test="title != null">
      AND title LIKE CONCAT('%', #{title}, '%')
    </if>
  </where>
</select>

优缺点分析

优点：

• 完全控制SQL，灵活性最高
• 性能最优，直接在数据库层完成分页
• 无需额外依赖，纯MyBatis功能

缺点：

• 代码侵入性高，每个分页查询都需要手动添加分页逻辑
• 需要处理不同数据库的分页语法
• 分页参数计算需要在业务代码中完成

适用场景

动态SQL分页适用于需要精确控制分页逻辑的场景，或者当项目中不希望引入额外分页依赖时。这种方式虽然代码侵入性高，但性能和灵活性都很好。

MyBatis的动态SQL相关文档可以参考src/site/markdown/dynamic-sql.md，其中详细介绍了if、choose、trim、foreach等标签的使用方法。

四种分页方案的对比与选择

分页方案	分页类型	实现复杂度	性能	易用性	灵活性	适用场景
RowBounds	逻辑分页	简单	差	高	低	数据量小的简单场景
拦截器分页	物理分页	中等	好	中	高	自定义分页逻辑
PageHelper插件	物理分页	简单	好	高	中	大多数分页场景
动态SQL分页	物理分页	中等	最好	低	最高	需精确控制SQL

选择建议

1. 数据量较小（<1000条）：可以选择RowBounds或动态SQL分页
2. 数据量中等（1000-10万条）：建议使用PageHelper插件或拦截器分页
3. 数据量大（>10万条）：优先考虑动态SQL分页或PageHelper插件
4. 需要自定义分页逻辑：选择拦截器分页或动态SQL分页
5. 多数据库兼容：优先选择PageHelper插件
6. 快速开发：PageHelper插件是最佳选择

分页查询性能优化技巧

1. 使用合适的索引

分页查询通常需要排序，因此确保排序字段上有合适的索引非常重要。例如：

-- 为排序字段创建索引
CREATE INDEX idx_blog_create_time ON blog(create_time);

2. 避免SELECT *

只查询需要的字段，减少数据传输和内存占用：

-- 不推荐
SELECT * FROM blog LIMIT 10, 20;

-- 推荐
SELECT id, title, create_time FROM blog LIMIT 10, 20;

3. 优化COUNT查询

总记录数查询（COUNT(*)）在大数据量表上可能性能较差，可以考虑：

• 使用近似值（如果业务允许）
• 缓存COUNT结果
• 使用数据库特定优化，如MySQL的COUNT(1)

4. 分页合理化

避免用户输入过大的页码导致性能问题，可以设置分页合理化：

• 页码小于1时，自动查询第一页
• 页码大于总页数时，自动查询最后一页

PageHelper插件提供了reasonable参数可以开启此功能。

5. 大数据量深分页优化

当offset很大时（如查询第1000页），传统的LIMIT offset, size性能会很差。可以使用"延迟关联"或"书签"技术优化：

-- 延迟关联优化
SELECT b.* FROM (
  SELECT id FROM blog ORDER BY create_time DESC LIMIT 100000, 10
) AS t
JOIN blog b ON t.id = b.id;

-- 书签技术（假设lastId是上一页的最后一条记录ID）
SELECT * FROM blog 
WHERE id < #{lastId}
ORDER BY id DESC 
LIMIT 10;

分页查询常见问题与解决方案

1. 分页参数传递问题

问题：当方法有多个参数时，分页参数可能无法正确识别。

解决方案：使用@Param注解明确指定参数名称：

List<Blog> selectBlogs(@Param("title") String title, 
                      @Param("pageNum") int pageNum, 
                      @Param("pageSize") int pageSize);

2. 不同数据库分页语法差异

问题：不同数据库的分页语法不同，导致SQL兼容性问题。

解决方案：

• 使用PageHelper插件自动适配不同数据库
• 使用MyBatis的databaseIdProvider功能：

<databaseIdProvider type="DB_VENDOR">
  <property name="MySQL" value="mysql"/>
  <property name="Oracle" value="oracle"/>
</databaseIdProvider>

然后在SQL中使用databaseId属性：

<select id="selectBlogs" resultType="Blog" databaseId="mysql">
  SELECT * FROM blog LIMIT #{offset}, #{pageSize}
</select>

<select id="selectBlogs" resultType="Blog" databaseId="oracle">
  SELECT * FROM (
    SELECT b.*, ROWNUM rn FROM blog b WHERE ROWNUM <= #{offset} + #{pageSize}
  ) WHERE rn > #{offset}
</select>

3. 分页查询与总数查询不一致

问题：分页查询结果总数与实际分页数据不一致。

解决方案：

• 确保分页查询和总数查询使用相同的过滤条件
• 避免在分页查询中使用SELECT DISTINCT
• 对于复杂查询，可以考虑使用子查询确保一致性

4. 大量数据分页性能问题

问题：当数据量很大且页码较大时，分页查询性能急剧下降。

解决方案：

• 使用"书签"分页代替传统的offset分页
• 限制最大页码，避免用户访问过大数据页
• 使用缓存热点数据页

总结

本文详细介绍了MyBatis的4种分页方案：RowBounds、拦截器、PageHelper插件和动态SQL，并对比分析了它们的优缺点和适用场景。选择合适的分页方案需要综合考虑数据量、性能要求、开发效率等因素。

无论选择哪种方案，都应该遵循分页查询的最佳实践：使用合适的索引、避免SELECT *、优化COUNT查询等。对于大数据量深分页场景，还需要采用特殊的优化技巧如延迟关联或书签技术。

MyBatis作为一款灵活的ORM框架，提供了多种分页解决方案，开发者可以根据项目实际需求选择最适合的方式。在大多数情况下，PageHelper插件是一个功能强大且易用的选择，能够满足大部分分页需求。

希望本文能够帮助你更好地理解和使用MyBatis分页功能，提升应用性能和用户体验。如果你有任何问题或建议，欢迎在评论区留言讨论。

官方文档：src/site/markdown/getting-started.md 动态SQL参考：src/site/markdown/dynamic-sql.md Java API文档：src/site/markdown/java-api.md

【免费下载链接】mybatis-3 MyBatis SQL mapper framework for Java 项目地址: https://gitcode.com/gh_mirrors/my/mybatis-3