【mybatisplus】版本升级后异常PaginationInnerInterceptor cannot be cast to org.apache.ibatis.plugin.Intercepto

原创最新推荐文章于 2026-05-19 10:30:41 发布 3.2k 阅读 AI写同款

收录于

中间件

ColdFireMan

码龄10年墨衍会员 · AI 创作全网分发

27粉丝112篇原创

关注

MyBatis-Plus 分页插件配置的两种方式如果你正在开发或维护一个基于 MyBatis-Plus 3.4.0 之前的项目，并且你的需求仅仅是分页功能，那么就足够了。对于 MyBatis-Plus 3.4.0 及之后的版本，官方推荐使用，因为它提供了更高的灵活性和更多的内置功能，可以根据实际需要轻松扩展应用的功能。阅读详情

AI摘要

本文记录了从 MyBatisPlus 3.1.2 升级到 3.5.2 版本过程中，解决分页插件 PaginationInterceptor 和乐观锁插件 OptimisticLockerInterceptor 类找不到的问题，以及如何正确配置这些插件。

升级mybatisplus从3.1.2到3.5.2错误修复记录

原来的mybatis-config.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <setting name="jdbcTypeForNull" value="NULL"/>
        <setting name="logImpl" value="SLF4J"/>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
    <plugins>
        <!-- 分页插件 -->
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor">
        </plugin>
        <!-- 乐观锁插件 -->
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.OptimisticLockerInterceptor">
        </plugin>
    </plugins>
</configuration>

升级mybatisplus从3.1.2->3.5.2版本后，PaginationInterceptor和OptimisticLockerInterceptor类找不到，查找新包以后，这两个类和路径已经改了，再改成：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <setting name="jdbcTypeForNull" value="NULL"/>
        <setting name="logImpl" value="SLF4J"/>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
    <plugins>
        <!-- 分页插件 -->
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor">
        </plugin>
        <!-- 乐观锁插件 -->
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor">
        </plugin>
    </plugins>
</configuration>

发现还是报错，提示：PaginationInnerInterceptor cannot be cast to org.apache.ibatis.plugin.Interceptor

查看官方文档，需要这样配置才正确：

正确的xm配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <setting name="jdbcTypeForNull" value="NULL"/>
        <setting name="logImpl" value="SLF4J"/>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
    <plugins>
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor">
            <!-- 分页插件 -->
            <property name="@page" value="com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor"/>
            <!-- 乐观锁插件 -->
            <property name="@version" value="com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor"/>
        </plugin>
    </plugins>
</configuration>

标签

#mybatis #mybatisplus