PageHelper 分页插件使用中的那些“坑”

引言

在项目开发过程中，分页查询是常见的需求之一。PageHelper 是一个 MyBatis 的分页插件，它能够自动完成 MyBatis 的分页功能。然而，在使用过程中可能会遇到一些问题，特别是当手动在 SQL 中使用了 <code>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">code>

<property name="helperDialect" value="mysql"/>code>

<property name="reasonable" value="true"/>code>

<property name="supportMethodsArguments" value="true"/>code>

<property name="params" value="count=countSql"/>code>

</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 resultType="MyEntity">code>

SELECT * FROM my_table

<!-- 不要在这里手动添加 LIMIT -->

</select>

特别注意

// 请求参数

int pageNum = 1; // 当前页码

int pageSize = 10; // 每页显示条

SELECT * FROM my_table limit ?,?

如果手动处理分页，只要mapper中参数中包含pageNum pageNum 参数分页插件都会进行分页。

总结

通过上述步骤，我们可以有效地避免 PageHelper 在不期望的时候进行分页操作，从而保证查询结果的准确性。在使用 PageHelper 时，一定要注意其配置和使用方法，确保不会影响到正常的 SQL 查询逻辑。

结语

希望这篇文章能帮助你在使用 PageHelper 分页插件时少走弯路。如果你在实际应用中遇到了其他问题，欢迎在评论区留言交流。