跳至主要內容

【高频面试】：MyBatis是如何进行分页的？

Corey2026/6/24大约 7 分钟面试题面试题

来源：【高频面试】：MyBatis是如何进行分页的？

image

一、引言：为什么分页如此重要？

在几乎所有的业务系统中，数据查询都是核心功能。当数据量只有几十、几百条时，我们可以一次性将其全部加载到前端展示。但想象一下，当一个数据表拥有上百万，甚至上千万条记录时（例如用户表、订单表），一次性查询所有数据将是一场灾难。这不仅会消耗大量的数据库资源和网络带宽，更可能直接导致应用程序因内存溢出（OOM）而崩溃。

因此，分页（Pagination）应运而生。它是一种将海量数据拆分成小块（页）进行分批次查询和展示的技术，是所有后端开发者必须熟练掌握的基本功，也是衡量系统性能和稳定性的关键指标之一。

MyBatis作为业界主流的持久层框架，提供了多种分页实现方式。理解它们的原理和优劣，是写出高性能、高可用数据接口的前提。

二、MyBatis分页的核心思想：两种模式的对决

在深入具体实现之前，我们必须先理解分页的两种根本不同的核心思想：逻辑分页和物理分页。

  • 逻辑分页 (Logical Pagination)：这是一种“伪分页”。它会从数据库中查询出所有符合条件的数据，然后将这些数据全部加载到应用程序的内存中，最后由代码（例如Java）根据分页参数（如页码、每页大小）截取出一小部分数据返回。
  • 物理分页 (Physical Pagination)：这是一种“真分页”。它会利用不同数据库自身提供的原生分页语法（如MySQL的LIMIT，Oracle的ROWNUM），在执行SQL查询时就直接告诉数据库：“我只需要第X页的Y条数据”。数据库只查询、返回指定范围的数据，开销极小。

image

显而易见，物理分页在性能上远胜于逻辑分页，是处理大数据量时的唯一正确选择。

三、MyBatis分页的四种实现方式

MyBatis社区在漫长的发展中，演化出了四种主流的分页实现方式，它们体现了从原始到优雅的进化过程。

方式一：在Mapper XML中直接编写SQL

这是最原始、最直接的方式。开发者需要在Mapper.xml文件中手动编写带有具体数据库分页语法的SQL语句。

<select id="selectUsersByPage" resultType="User">
  SELECT * FROM user
  LIMIT #{offset}, #{limit}
</select>

  • 优点：

  • 简单直观，易于理解。

  • 无需任何额外配置或依赖。

  • 缺点：

  • 硬编码，维护成本高：SQL与特定数据库（此处为MySQL）强绑定，若要更换数据库，所有分页SQL都需重写。

  • 参数繁琐：需要手动计算并传入offset（偏移量）和limit（每页数量）等参数。

  • 代码重复：每个需要分页的查询都需要重复编写类似的分页逻辑。

方式二：使用 RowBounds 对象

MyBatis提供了一个名为RowBounds的内置对象，试图在不改变SQL的情况下实现分页。

// Service层调用
List<User> users = userMapper.selectAll(new RowBounds(10, 10)); // 获取第二页，每页10条

// Mapper接口
List<User> selectAll(); // SQL本身不含分页逻辑

image

  • 优点：

  • 无需在SQL中硬编码分页逻辑，实现了SQL的解耦。

  • 缺点：

  • 本质是逻辑分页：它会加载所有数据到内存中，然后通过ResultSet.absolute()和FetchSize等JDBC特性进行数据截取。在数据量大时，依然会引发致命的内存溢出问题。

  • 仅适用于小数据量场景：只适合于确定数据量极小（如几百条）的查询。

方式三：使用 Interceptor 拦截器

为了解决以上问题，MyBatis提供了强大的Interceptor（拦截器）机制。它允许开发者在SQL执行的生命周期（如参数处理、SQL执行、结果集处理）中插入自定义逻辑，这为实现统一的物理分页提供了可能。

实现逻辑通常如下：

  1. 定义拦截器：创建一个类实现MyBatis的Interceptor接口。
  2. 拦截目标SQL：配置拦截器，使其在SQL执行前触发。
  3. 动态改写SQL：在拦截方法中，获取原始SQL，判断是否需要分页，如果需要，则根据数据库类型动态地在原始SQL末尾拼接上物理分页子句（如LIMIT）。
  4. 执行新SQL：将改写后的SQL交由MyBatis继续执行。

image

  • 优点：

  • 实现真正的物理分页，性能高。

  • 逻辑统一：将分页逻辑从业务代码中抽离，实现了一次配置，全局生效。

  • 缺点：

  • 实现复杂：需要深入理解MyBatis的内部执行原理，如Executor、StatementHandler等核心组件，开发门槛较高，容易出错。

方式四：使用分页插件（如 PageHelper）- ⭐生产首选⭐

既然基于Interceptor实现统一物理分页是最佳思路，但手写又很复杂，那么成熟的开源插件便应运而生。PageHelper是其中最著名、使用最广泛的实现。

它将所有复杂的拦截器逻辑都封装好了，开发者只需引入依赖，进行简单配置，然后通过一行静态代码即可开启分页。

// 1. 引入依赖 & 配置插件

// 2. 在业务代码中调用
PageHelper.startPage(1, 10); // 紧跟其后的第一条MyBatis查询会自动被分页
List<User> users = userMapper.selectAll(); // SQL本身依然是干净的
PageInfo&lt;User&gt; pageInfo = new PageInfo<>(users); // PageInfo包含了总数、总页数等丰富信息

image

  • 优点：

  • 集大成者：拥有Interceptor方案的所有优点，且规避了其实现复杂的缺点。

  • 使用极其简单：非侵入式设计，对现有代码影响极小。

  • 功能强大：自动进行count查询获取总记录数，返回的PageInfo对象包含完整的的分页信息。

  • 智能适配：能自动识别数据库类型，生成对应的分页SQL。

四、如何选择最佳方案？决策矩阵

image

五、结论

MyBatis的分页实现经历了从手动到自动，从逻辑分页到物理分页的演进。在现代项目开发中，我们应该毫不犹豫地选择像PageHelper这样的成熟分页插件。它不仅能保证最佳的查询性能，还能极大地提升开发效率，让我们专注于业务逻辑本身。

面试核心答案：当被问及MyBatis如何分页时，标准的回答应该覆盖“逻辑分页与物理分页的区别”，并点明“插件（如PageHelper）利用Interceptor机制实现自动化物理分页是当前业界的最佳实践”。