PageHelper 分页插件使用中的那些“坑”
引言
在项目开发过程中，分页查询是常见的需求之一。PageHelper 是一个 MyBatis 的分页插件，它能够自动完成 MyBatis 的分页功能。然而，在使用过程中可能会遇到一些问题，特别是当手动在 SQL 中使用了 LIMIT 进行分页的情况下。本文将探讨这些问题，并给出相应的解决办法。
背景
假设我们的应用需要从数据库中获取分页数据，我们决定使用 PageHelper 插件来简化分页逻辑。但在实际使用中，我们发现即使没有显式地调用 PageHelper 的分页方法，SQL 查询中仍然出现了 LIMIT 子句，导致数据返回不正确。
问题描述
现象
- 在没有启用 PageHelper 分页功能的情况下，SQL 查询语句中出现了
LIMIT分页子句。 - 数据量大时，查询结果不正确，只返回了部分数据。
原因分析
- PageHelper 默认会在查询之前自动添加分页逻辑，如果没有正确配置或禁用 PageHelper，它可能会干扰正常的 SQL 查询。
- 当在业务逻辑中手动添加了
LIMIT子句时，PageHelper 会再次添加LIMIT导致重复分页。
解决方案
检查 PageHelper 是否已被正确配置
确认 PageHelper 已经被正确地添加到 MyBatis 的配置中，并且全局分页开关已开启。
<dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>最新版本</version>
</dependency>
在 MyBatis 的全局配置文件中启用 PageHelper。
<plugins><plugin interceptor="com.github.pagehelper.PageInterceptor"><property name="helperDialect" value="mysql"/><property name="reasonable" value="true"/><property name="supportMethodsArguments" value="true"/><property name="params" value="count=countSql"/></plugin>
</plugins>
正确使用 PageHelper
如果需要使用 PageHelper 进行分页，确保在查询之前正确调用 PageHelper.startPage() 方法。
int pageNum = 1; // 当前页码
int pageSize = 10; // 每页显示条数
PageHelper.startPage(pageNum, pageSize);
List<MyEntity> list = myMapper.selectAll();
禁用特定查询的分页功能
如果某个特定的查询不需要分页，可以在查询之前调用 PageHelper.clearPage() 方法来清除当前的分页状态。
PageHelper.clearPage();
List<MyEntity> list = myMapper.selectAll();
避免手动添加 LIMIT
不要在 SQL 查询中手动添加 LIMIT 子句，让 PageHelper 自动处理分页逻辑。
<select id="selectAll" resultType="MyEntity">SELECT * FROM my_table<!-- 不要在这里手动添加 LIMIT -->
</select>
特别注意
// 请求参数
int pageNum = 1; // 当前页码
int pageSize = 10; // 每页显示条
SELECT * FROM my_table limit ?,?
如果手动处理分页，只要mapper中参数中包含pageNum pageNum 参数分页插件都会进行分页。
总结
通过上述步骤，我们可以有效地避免 PageHelper 在不期望的时候进行分页操作，从而保证查询结果的准确性。在使用 PageHelper 时，一定要注意其配置和使用方法，确保不会影响到正常的 SQL 查询逻辑。
结语
希望这篇文章能帮助你在使用 PageHelper 分页插件时少走弯路。如果你在实际应用中遇到了其他问题，欢迎在评论区留言交流。
