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

 更新时间:2025年08月09日 15:37:05   作者:一叶飘零_sweeeet  
作为Java开发者,我们都爱用Mybatis-Plus简化CRUD操作,尤其是它的分页功能,几行代码就能搞定复杂的分页查询,本文给大家介绍Mybatis-Plus3.5.12分页拦截器消失的问题快速解决方法,感兴趣的朋友跟随小编一起看看吧

作为 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 // 是否有上一页
}
}

五、常见问题排查

  • 分页不生效?
    • 检查是否配置了分页拦截器
    • 确认依赖是否正确引入
    • 查看是否有多个拦截器冲突
  • 分页语句错误?
    • 确保指定了正确的数据库类型
    • 检查实体类与表结构映射是否正确
  • 依赖冲突?
    • 用mvn dependency:tree查看依赖树,排除冲突版本
    • 确保 Mybatis-Plus 各模块版本一致

六、总结

Mybatis-Plus 的分页功能大大简化了我们的开发工作,但版本升级带来的依赖变化可能会让新手踩坑。记住 3.5.x 版本后需要单独引入mybatis-plus-extension依赖才能使用分页拦截器,这是解决PaginationInnerInterceptor类不存在问题的关键。

希望这篇文章能帮你彻底搞懂 Mybatis-Plus 分页功能的配置和使用,如果你还有其他相关问题,欢迎在评论区交流!

到此这篇关于Mybatis-Plus 3.5.12 分页拦截器消失的文章就介绍到这了,更多相关MybatisPlus 分页拦截器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot拦截器的配置使用介绍

    SpringBoot拦截器的配置使用介绍

    拦截器可以用来实现未满足某些条件,不容许访问某些资源。SpringBoot 支持拦截器,本文主要介绍拦截器的使用与原理
    2022-10-10
  • 使用Sharding-JDBC对数据进行分片处理详解

    使用Sharding-JDBC对数据进行分片处理详解

    这篇文章主要介绍了使用Sharding-JDBC对数据进行分片处理详解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-10-10
  • 详解SpringBoot启动类的扫描注解的用法及冲突原则

    详解SpringBoot启动类的扫描注解的用法及冲突原则

    这篇文章主要介绍了详解SpringBoot启动类的扫描注解的用法及冲突原则,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • MybatisPlus #{param}和${param}的用法详解

    MybatisPlus #{param}和${param}的用法详解

    这篇文章主要介绍了MybatisPlus #{param}和${param}的用法详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • java 基于maven多模块合并打包部署的操作过程

    java 基于maven多模块合并打包部署的操作过程

    这篇文章主要介绍了java 基于maven多模块合并打包部署的操作过程,本文通过实例代码图文相结合给大家介绍的非常详细,需要的朋友可以参考下
    2023-02-02
  • JdbcTemplate方法介绍与增删改查操作实现

    JdbcTemplate方法介绍与增删改查操作实现

    这篇文章主要给大家介绍了关于JdbcTemplate方法与增删改查操作实现的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者使用JdbcTemplate具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-11-11
  • Java分布式锁、分布式ID和分布式事务的实现方案

    Java分布式锁、分布式ID和分布式事务的实现方案

    在分布式系统中,分布式锁、分布式ID和分布式事务是常用的组件,用于解决并发控制、唯一标识和数据一致性的问题,本文将介绍Java中常用的分布式锁、分布式ID和分布式事务的实现方案,并通过具体的示例代码演示它们的用法和应用场景
    2023-06-06
  • Java总结篇系列:Java泛型详解

    Java总结篇系列:Java泛型详解

    下面小编就为大家带来一篇Java总结篇系列:Java泛型详解。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-09-09
  • Java mockito单元测试实现过程解析

    Java mockito单元测试实现过程解析

    这篇文章主要介绍了Java mockito单元测试实现过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-08-08
  • Java中的转换流、压缩流、序列化流、打印流及应用场景

    Java中的转换流、压缩流、序列化流、打印流及应用场景

    这篇文章主要介绍了Java中的转换流、压缩流、序列化流、打印流及应用场景,本文结合示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-06-06

最新评论