Mybatis-Plus 3.5.12 分页拦截器消失的问题及快速解决方法_Java

作为 java 开发者，我们都爱用 mybatis-plus 简化 crud 操作，尤其是它的分页功能，几行代码就能搞定复杂的分页查询。但最近有位朋友在集成 mybatis-plus 3.5.12 版本时踩了个坑：paginationinnerinterceptor类突然找不到了！这篇文章就来聊聊这个问题的来龙去脉，教你快速解决，还会附赠分页功能的完整使用指南。

一、问题场景：分页拦截器突然 “失踪”

先看一段熟悉的配置代码，这是我们常用的 mybatis-plus 分页配置：

package com.xx.config.mybatis;
import com.baomidou.mybatisplus.extension.plugins.mybatisplusinterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.paginationinnerinterceptor;
import org.mybatis.spring.annotation.mapperscan;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
@configuration
@mapperscan({"com.sq.twinbee.**.mapper"})
public class mybatisplusconfig {
@bean
public mybatisplusinterceptor mybatisplusinterceptor() {
mybatisplusinterceptor interceptor = new mybatisplusinterceptor();
// 添加分页拦截器
interceptor.addinnerinterceptor(new paginationinnerinterceptor());
return interceptor;
}
}

当使用 mybatis-plus 3.5.12 版本时，ide 突然报错：paginationinnerinterceptor类不存在！这是怎么回事？明明之前的版本用得好好的，难道是版本升级后类被移除了？

二、问题根源：依赖拆分惹的祸

其实不是类被移除了，而是 mybatis-plus 在 3.5.0 版本后对依赖进行了拆分。在早期版本中，分页插件和核心包是捆绑在一起的，但从 3.5.0 开始，官方将一些扩展功能（包括分页插件）单独拆分成了mybatis-plus-extension模块。

如果你在 pom.xml 中只引入了核心包：

<dependency>
<groupid>com.baomidou</groupid>
<artifactid>mybatis-plus-core</artifactid>
<version>3.5.12</version>
</dependency>

就会找不到paginationinnerinterceptor，因为它已经被移到mybatis-plus-extension里了。

三、解决办法：添加扩展依赖

只需在 pom.xml 中添加mybatis-plus-extension依赖，问题就能迎刃而解：

<dependency>
<groupid>com.baomidou</groupid>
<artifactid>mybatis-plus-extension</artifactid>
<version>3.5.12</version>
</dependency>

为什么这行依赖能解决问题？

mybatis-plus-extension是 mybatis-plus 的扩展模块，包含了分页插件、性能分析插件等增强功能

3.5.12 版本严格遵循 “按需引入” 原则，核心包只保留最基础的 crud 功能

扩展模块与核心包版本必须保持一致，否则可能出现兼容性问题

四、分页功能完整使用指南

解决了依赖问题，我们再来完整梳理一下 mybatis-plus 分页功能的使用步骤，确保新手也能快速上手。

步骤 1：配置分页拦截器

就是我们开头提到的配置类，这里再强调几个注意点：

@configuration
@mapperscan({"com.xx.**.mapper"}) // 扫描mapper接口所在包
public class mybatisplusconfig {
@bean
public mybatisplusinterceptor mybatisplusinterceptor() {
mybatisplusinterceptor interceptor = new mybatisplusinterceptor();
// 注意：这里可以指定数据库类型，避免分页语句适配问题
interceptor.addinnerinterceptor(new paginationinnerinterceptor(dbtype.mysql));
return interceptor;
}
}

关键说明：

建议明确指定数据库类型（如dbtype.mysql），mybatis-plus 会根据数据库类型生成对应的分页 sql（mysql 用 limit，oracle 用 rownum）

拦截器可以添加多个，比如同时添加分页拦截器和乐观锁拦截器

步骤 2：编写 mapper 接口

无需手动写分页 sql，直接继承basemapper即可：

public interface usermapper extends basemapper<user> {
// 自定义分页查询（可选）
ipage<user> selectuserbyage(page<user> page, @param("age") integer age);
}

步骤 3：service 层调用

@service
public class userserviceimpl extends serviceimpl<usermapper, user> implements userservice {
@override
public ipage<user> getuserpage(integer pagenum, integer pagesize) {
// 创建分页对象
page<user> page = new page<>(pagenum, pagesize);
// 调用basemapper的selectpage方法
return basemapper.selectpage(page, null);
}
@override
public ipage<user> getuserbyage(integer pagenum, integer pagesize, integer age) {
page<user> page = new page<>(pagenum, pagesize);
// 调用自定义分页方法
return basemapper.selectuserbyage(page, age);
}
}

步骤 4：controller 层使用

@restcontroller
@requestmapping("/user")
public class usercontroller {
@autowired
private userservice userservice;
@getmapping("/page")
public result<ipage<user>> getuserpage(
@requestparam(defaultvalue = "1") integer pagenum,
@requestparam(defaultvalue = "10") integer pagesize) {
ipage<user> page = userservice.getuserpage(pagenum, pagesize);
return result.success(page);
}
}

步骤 5：分页结果解析

分页查询返回的ipage对象包含了丰富的分页信息：

{
"code": 200,
"msg": "success",
"data": {
"records": [
{"id": 1, "name": "张三", "age": 20},
{"id": 2, "name": "李四", "age": 22}
],
"total": 100, // 总记录数
"size": 10, // 每页条数
"current": 1, // 当前页码
"pages": 10, // 总页数
"hasnext": true, // 是否有下一页
"hasprevious": false // 是否有上一页
}
}