Mybatis Plus 3.4以上分页无效问题解决方法

问题描述

在使用 Mybatis Plus 3.4 及以上版本时，发现分页功能无效的情况。即使在查询语句中设置了分页参数，但返回的结果仍然是不分页的。

问题原因分析

Mybatis Plus 3.4 版本引入了新的分页插件 MybatisPlusInterceptor，该插件用于对查询语句进行拦截和增强，实现分页功能。但在一些特定情况下，该插件可能无法正确的拦截查询语句，导致分页失效。

解决方法

针对该问题，我们可以采取以下解决方法：

方法一：在配置文件中手动添加分页插件

打开 Mybatis Plus 的配置文件 mybatis-plus.yml（或者 mybatis-plus-config.xml）。
在配置文件中添加以下内容，手动启用分页插件：

<plugins>
    <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.pagination.PageInterceptor">
        <property name="dialect" value="yourDialect"/>
    </plugin>
</plugins>

其中，yourDialect 为数据库方言，如 MySQL、Oracle 等。

重新运行项目，检查分页功能是否生效。

方法二：添加分页插件的依赖

打开你的项目的 pom.xml 文件。
在 dependencies 标签中添加以下内容，引入分页插件的依赖：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.4.1</version>
</dependency>

请根据你的项目实际情况，调整 mybatis-plus-boot-starter 的版本号。

重新运行项目，检查分页功能是否生效。

方法三：通过自定义拦截器解决

创建一个自定义的拦截器类，实现 Interceptor 接口，并重写其 intercept 和 plugin 方法。
在 intercept 方法中，对查询语句进行拦截，并修改其中的分页参数。
在 plugin 方法中，将自定义拦截器应用到 Mybatis Plus 的拦截器链中。
在配置文件中，将自定义拦截器添加到 Mybatis Plus 的配置中：

<plugins>
    <plugin interceptor="com.example.MyInterceptor">
        <property name="dialect" value="yourDialect"/>
    </plugin>
</plugins>

其中，com.example.MyInterceptor 为自定义拦截器的类名。

重新运行项目，检查分页功能是否生效。

方法四：回退到使用 Mybatis Plus 3.3 版本

如果以上方法都无法解决问题，你可以尝试回退到使用 Mybatis Plus 3.3 版本，该版本没有引入分页插件，因此分页功能不存在问题。

总结

以上就是解决 Mybatis Plus 3.4以上版本分页无效问题的方法介绍。根据你的具体情况选择合适的方法，重新运行项目，即可解决分页无效的问题。希望本文对你有所帮助，谢谢阅读！

参考文献：