突破分页难题：Mybatis-PageHelper如何优雅处理UNION与子查询场景

在日常开发中，你是否遇到过这些分页痛点？复杂的UNION查询返回结果错乱，嵌套子查询导致分页失效，或者分页插件生成的COUNT语句执行效率低下？本文将详解Mybatis-PageHelper（通用分页插件）如何攻克这些特殊SQL场景，通过实战案例带你掌握高级分页技巧。

特殊SQL分页的技术挑战

传统分页插件在处理包含UNION、子查询的SQL时，常出现两类问题：一是分页逻辑错误导致数据重复或丢失，二是自动生成的COUNT语句性能低下。这些问题的根源在于复杂SQL的语法解析难度，以及不同数据库对分页语法的差异化支持。

Mybatis-PageHelper通过三层架构解决这些挑战：

• SQL解析层：src/main/java/com/github/pagehelper/parser/CountSqlParser.java定义了聚合函数识别规则，确保COUNT语句生成准确性
• 方言适配层：src/main/java/com/github/pagehelper/dialect/helper/下20+数据库方言实现，针对性处理不同数据库的分页语法
• 执行拦截层：src/main/java/com/github/pagehelper/PageInterceptor.java通过MyBatis拦截器机制，在SQL执行前动态改写

UNION查询分页实现方案

UNION查询由于涉及多表合并，分页处理需特别注意结果集的完整性。PageHelper通过特殊的SQL包装策略，确保分页逻辑正确应用于合并后的结果集。

实现原理

1. 自动识别UNION结构：通过语法解析识别多段SQL合并场景
2. 整体包装分页逻辑：将UNION查询整体作为子查询，外层应用LIMIT/OFFSET
3. 智能COUNT生成：自动生成COUNT(*)语句，避免对每个子查询单独计数

代码示例

// 获取第1页，10条内容，默认查询总数count
PageHelper.startPage(1, 10);
List<User> list = userMapper.selectUnion();
// 分页结果强转为Page对象获取总数
long total = ((Page<?>) list).getTotal();

测试案例src/test/java/com/github/pagehelper/test/basic/sql/TestUnion.java验证了UNION分页的正确性，当执行：

PageHelper.startPage(2, 10);
list = userMapper.selectUnion();

插件会自动将原始UNION查询改写为：

SELECT * FROM (
  SELECT id,name FROM table1 
  UNION ALL 
  SELECT id,name FROM table2
) temp_table LIMIT 10 OFFSET 10

子查询分页解决方案

子查询分页是另一个常见痛点，特别是当分页逻辑需要应用于内层查询还是外层查询时，很容易产生混淆。PageHelper提供两种处理策略应对不同场景。

场景一：内层子查询分页

适用于需要先筛选子查询结果，再进行分页的场景。例如：

// 分页应用于子查询
PageHelper.startPage(1, 10);
List<User> list = userMapper.selectWithSubQuery();

插件会智能识别子查询结构，将分页条件应用于内层查询：

SELECT * FROM (
  SELECT * FROM (
    SELECT id,name FROM user WHERE status=1
  ) temp LIMIT 10 OFFSET 0
) result

场景二：外层结果分页

当需要先执行完整子查询，再对结果进行分页时，可通过参数配置强制外层分页：

// 配置参数强制外层分页
PageHelper.startPage(1, 10).setReasonable(true);
List<User> list = userMapper.selectWithOuterPagination();

关键配置参数

参数名	作用	默认值
reasonable	分页合理化，处理页码越界	false
pageSizeZero	支持pageSize=0查询全部	false
offsetAsPageNum	将offset转为pageNum参数	false

详细参数说明可参考wikis/zh/HowToUse.md中的"分页插件参数介绍"章节。

高级配置与性能优化

针对复杂SQL场景，适当的配置优化可以显著提升分页性能。以下是针对特殊SQL场景的优化建议：

1. 自定义COUNT列

当默认COUNT(0)性能不佳时，可通过配置指定更优的COUNT列：

<plugin interceptor="com.github.pagehelper.PageInterceptor">
  <!-- 配置COUNT查询使用的列 -->
  <property name="countColumn" value="id"/>
</plugin>

2. 关闭自动COUNT

对于确知总数或无需总数的场景，可关闭自动COUNT查询提升性能：

// 仅分页不查询总数
Page<Object> page = PageHelper.startPage(1, 10).setCount(false);

3. 聚合函数处理

src/main/java/com/github/pagehelper/parser/CountSqlParser.java定义了30+聚合函数识别规则，确保包含聚合函数的查询能正确生成COUNT语句。当遇到复杂统计查询时，可通过：

CountSqlParser.addAggregateFunctions("CUSTOM_FUNC,NEW_FUNC");

扩展自定义聚合函数支持。

常见问题与解决方案

问题1：UNION ALL与UNION区别处理

UNION会去重而UNION ALL保留重复项，PageHelper会根据SQL关键字自动选择合适的COUNT策略。使用时需注意：

• UNION场景：COUNT会计算去重后总数
• UNION ALL场景：COUNT会计算所有记录数（含重复）

问题2：深度嵌套子查询分页失效

当子查询嵌套超过3层时，建议使用/*keep orderby*/注释强制保留排序：

SELECT * FROM (
  /*keep orderby*/
  SELECT * FROM table WHERE status=1 ORDER BY create_time DESC
) temp LIMIT 10

问题3：Oracle数据库ROWNUM问题

Oracle数据库使用ROWNUM进行分页时，需特别注意排序与分页的顺序。PageHelper的OracleDialect实现已处理这一问题，自动生成：

SELECT * FROM (
  SELECT t.*, ROWNUM rn FROM (
    SELECT id,name FROM user ORDER BY create_time DESC
  ) t WHERE ROWNUM <= 20
) WHERE rn > 10

最佳实践总结

1. SQL书写规范：

   • UNION查询使用UNION ALL代替UNION（除非确需去重）
   • 子查询尽量简化，避免超过3层嵌套
   • 排序字段确保有索引支持

2. 参数配置建议：

   <plugin interceptor="com.github.pagehelper.PageInterceptor">
     <property name="reasonable" value="true"/>
     <property name="supportMethodsArguments" value="true"/>
     <property name="params" value="pageNum=pageNum;pageSize=pageSize"/>
   </plugin>
   

3. 分页方式选择：

   • 简单查询：使用PageHelper.startPage()静态方法
   • 复杂场景：使用ISelect接口确保线程安全

   Page<User> page = PageHelper.startPage(1, 10)
     .doSelectPage(() -> userMapper.selectComplex());
   

通过以上方案，Mybatis-PageHelper能够优雅处理各类特殊SQL分页场景，既保证了功能正确性，又兼顾了性能优化。官方文档wikis/zh/HowToUse.md提供了更全面的使用指南，建议结合实际业务场景参考配置。