MyBaitis-Plus 使用动态表名 selectPage 不生效

已于 2025-03-28 17:27:28 修改
阅读量555 收藏 5
点赞数 3
分类专栏： Java 文章标签： java mybatis
于 2025-03-28 16:09:58 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_47054648/article/details/146603703
版权

在使用 MyBatis-Plus 时，采用动态表名策略后，selectPage 方法无法正常生效。

MyBatis-Plus动态表名插件配置

以下是我项目中 MyBatis - Plus 的插件配置：

import cn.hutool.core.net.NetUtil;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import com.baomidou.mybatisplus.core.handlers.PostInitTableInfoHandler;
import com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator;
import com.baomidou.mybatisplus.core.incrementer.IdentifierGenerator;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.DynamicTableNameInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.dromara.common.core.factory.YmlPropertySourceFactory;
import org.dromara.common.core.utils.SpringUtils;
import org.dromara.common.mybatis.aspect.DataPermissionAspect;
import org.dromara.common.mybatis.handler.InjectionMetaObjectHandler;
import org.dromara.common.mybatis.handler.MybatisExceptionHandler;
import org.dromara.common.mybatis.handler.PlusPostInitTableInfoHandler;
import org.dromara.common.mybatis.interceptor.PlusDataPermissionInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.PropertySource;
import org.springframework.transaction.annotation.EnableTransactionManagement;

import static org.dromara.common.core.utils.ServletUtils.getLanguage;

/**
 * mybatis-plus配置类
 */
@EnableTransactionManagement(proxyTargetClass = true)
@MapperScan("${mybatis-plus.mapperPackage}")
@PropertySource(value = "classpath:common-mybatis.yml", factory = YmlPropertySourceFactory.class)
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 数据权限处理
        interceptor.addInnerInterceptor(dataPermissionInterceptor());
        // 分页插件
        interceptor.addInnerInterceptor(paginationInnerInterceptor());
        // 乐观锁插件
        interceptor.addInnerInterceptor(optimisticLockerInnerInterceptor());
        // 动态表名插件
        interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor());
        return interceptor;
    }

    /**
     * 动态表名插件
     */
    public DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor() {
        DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
        dynamicTableNameInnerInterceptor.setTableNameHandler((sql, tableName) -> switch (tableName) {
            case "device_type","device_model" -> tableName + "_" + getLanguage();
            default -> tableName;
        });
        return dynamicTableNameInnerInterceptor;
    }

    /**
     * 数据权限拦截器
     */
    public PlusDataPermissionInterceptor dataPermissionInterceptor() {
        return new PlusDataPermissionInterceptor(SpringUtils.getProperty("mybatis-plus.mapperPackage"));
    }

    /**
     * 数据权限切面处理器
     */
    @Bean
    public DataPermissionAspect dataPermissionAspect() {
        return new DataPermissionAspect();
    }

    /**
     * 分页插件，自动识别数据库类型
     */
    public PaginationInnerInterceptor paginationInnerInterceptor() {
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor();
        // 分页合理化
        paginationInnerInterceptor.setOverflow(true);
        return paginationInnerInterceptor;
    }

    /**
     * 乐观锁插件
     */
    public OptimisticLockerInnerInterceptor optimisticLockerInnerInterceptor() {
        return new OptimisticLockerInnerInterceptor();
    }

    /**
     * 元对象字段填充控制器
     */
    @Bean
    public MetaObjectHandler metaObjectHandler() {
        return new InjectionMetaObjectHandler();
    }

    /**
     * 使用网卡信息绑定雪花生成器
     * 防止集群雪花ID重复
     */
    @Bean
    public IdentifierGenerator idGenerator() {
        return new DefaultIdentifierGenerator(NetUtil.getLocalhost());
    }

    /**
     * 异常处理器
     */
    @Bean
    public MybatisExceptionHandler mybatisExceptionHandler() {
        return new MybatisExceptionHandler();
    }

    /**
     * 初始化表对象处理器
     */
    @Bean
    public PostInitTableInfoHandler postInitTableInfoHandler() {
        return new PlusPostInitTableInfoHandler();
    }
    
}

MyBatis-Plus动态表名失效原因

在运用 com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor 时，其 intercept 方法具备这样一种特性：每进行一次 SQL 查询操作，该方法便会对已加载的全部拦截器进行逐一遍历。在实际应用场景中，尤其是当你需要对 device_type 和 device_model 库开展动态表名查询时，这一机制可能会带来一些影响。
在这里插入图片描述

举例来说，若你希望依据语言环境动态拼接表名，当当前语言为 zh_CN 时，就会去查询 device_type_zh_CN 表。经过多次测试后发现，使用 selectById 或者 selectList 方法能够顺利完成查询任务，但使用 selectPage 方法时却会报错。经过深入分析，问题的根源在于拦截器的执行顺序存在不当之处。
实际上，在使用 com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor 执行 SQL 查询时，intercept 方法会对以 List 形式存储的拦截器进行遍历。通常情况下，第一个被调用的拦截器是分页查询拦截器，也就是 com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor 类中的 willDoQuery 方法。在这个 willDoQuery 方法里，会触发一次额外的数据库查询操作，而恰恰是这次额外的查询操作，最终引发了报错问题。
在这里插入图片描述

MyBatis-Plus动态表名失效解决办法

通过调整拦截器的顺序，把分页拦截器置于动态表名拦截器之后，便可有效解决当前面临的问题。

import cn.hutool.core.net.NetUtil;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import com.baomidou.mybatisplus.core.handlers.PostInitTableInfoHandler;
import com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator;
import com.baomidou.mybatisplus.core.incrementer.IdentifierGenerator;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.DynamicTableNameInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.dromara.common.core.factory.YmlPropertySourceFactory;
import org.dromara.common.core.utils.SpringUtils;
import org.dromara.common.mybatis.aspect.DataPermissionAspect;
import org.dromara.common.mybatis.handler.InjectionMetaObjectHandler;
import org.dromara.common.mybatis.handler.MybatisExceptionHandler;
import org.dromara.common.mybatis.handler.PlusPostInitTableInfoHandler;
import org.dromara.common.mybatis.interceptor.PlusDataPermissionInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.PropertySource;
import org.springframework.transaction.annotation.EnableTransactionManagement;

import static org.dromara.common.core.utils.ServletUtils.getLanguage;

/**
 * mybatis-plus配置类
 */
@EnableTransactionManagement(proxyTargetClass = true)
@MapperScan("${mybatis-plus.mapperPackage}")
@PropertySource(value = "classpath:common-mybatis.yml", factory = YmlPropertySourceFactory.class)
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 数据权限处理
        interceptor.addInnerInterceptor(dataPermissionInterceptor());
        // 动态表名插件
        interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor());
        // 分页插件
        interceptor.addInnerInterceptor(paginationInnerInterceptor());
        // 乐观锁插件
        interceptor.addInnerInterceptor(optimisticLockerInnerInterceptor());
        return interceptor;
    }

    /**
     * 动态表名插件
     */
    public DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor() {
        DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
        dynamicTableNameInnerInterceptor.setTableNameHandler((sql, tableName) -> switch (tableName) {
            case "device_type","device_model" -> tableName + "_" + getLanguage();
            default -> tableName;
        });
        return dynamicTableNameInnerInterceptor;
    }

    /**
     * 数据权限拦截器
     */
    public PlusDataPermissionInterceptor dataPermissionInterceptor() {
        return new PlusDataPermissionInterceptor(SpringUtils.getProperty("mybatis-plus.mapperPackage"));
    }

    /**
     * 数据权限切面处理器
     */
    @Bean
    public DataPermissionAspect dataPermissionAspect() {
        return new DataPermissionAspect();
    }

    /**
     * 分页插件，自动识别数据库类型
     */
    public PaginationInnerInterceptor paginationInnerInterceptor() {
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor();
        // 分页合理化
        paginationInnerInterceptor.setOverflow(true);
        return paginationInnerInterceptor;
    }

    /**
     * 乐观锁插件
     */
    public OptimisticLockerInnerInterceptor optimisticLockerInnerInterceptor() {
        return new OptimisticLockerInnerInterceptor();
    }

    /**
     * 元对象字段填充控制器
     */
    @Bean
    public MetaObjectHandler metaObjectHandler() {
        return new InjectionMetaObjectHandler();
    }

    /**
     * 使用网卡信息绑定雪花生成器
     * 防止集群雪花ID重复
     */
    @Bean
    public IdentifierGenerator idGenerator() {
        return new DefaultIdentifierGenerator(NetUtil.getLocalhost());
    }

    /**
     * 异常处理器
     */
    @Bean
    public MybatisExceptionHandler mybatisExceptionHandler() {
        return new MybatisExceptionHandler();
    }

    /**
     * 初始化表对象处理器
     */
    @Bean
    public PostInitTableInfoHandler postInitTableInfoHandler() {
        return new PlusPostInitTableInfoHandler();
    }

}
MybatisPlus分页失效不起作用问题剖析
benben044的专栏
03-10 3083
在使用MybatisPlus的selectPage时发现分页不起作用，每次返回的都是全部的数据，同时getPages()和getTotal()返回的都是0。初步怀疑是拦截器没有生效，为了验证这一点，在mybatisPlusInterceptor()函数中打一个断点。执行测试程序，发现确实没有进入这个函数。然后再执行debug，发现可以进入mybatisPlusInterceptor的断点。查看springboot的启动返回，发现确实没有扫描到这个包文件。
十四、SpringBoot整合Mybatis Plus
阿彬得博客
03-09 641
一、MybatisPlus简介 1、简介 MyBatis-Plus (opens new window)（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。 2、特性 ①无侵入：只做增强不做改变。 ②损耗小：启动时自动注入基本 CURD，性能基本无损耗，直接面向对象操作。 ③强大的 CRUD 操作：内置通用 Mapper、通用 Service，少量配置实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求。 ④支持 La
零碎06 Mybatis分页selectPage不生效
Elaine2391的博客
11-23 1803
发现问题：酷乐在使用MybatisPlus的方法时，发现分页功能失效，总是返回全量数据。查找原因：通过逐步排查，发现问题是由于没有配置插件。的作用是在SQL执行前动态修改SQL语句，使其支持分页查询。分析方案：理解了的工作原理后，酷乐决定配置该插件，确保分页功能正常工作。解决问题：通过在Spring Boot的配置类中添加插件的配置，并确保分页参数正确传递，最终解决了分页失效的问题。通过这次经历，酷乐不仅解决了当前的问题，还对MybatisPlus的分页功能有了更深入的理解。
MyBaitis-Plus 使用动态表名 selectPage 不生效！
2401_83384536的博客
04-23 821
经过多次测试，selectById 或者 selectList方法都是可以正常查询的，但是selectPage会报错如上，具体的原因是拦截器的顺序导致的问题。com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor#intercept 在每执行一次sql查询的时候，都会遍历一次加载的拦截器。其中我需要对delivery_file_print_log的库实现动态表名的查询，比如今年是23年，那么查询的库表应该是。
Mybatis-plus的selectPage()分页查询不生效问题
州仔
03-21 1300
项目使用mubits-plus,发现分页查询查询一直不生效。
【Mybatis-plus系列】使用Mybatis-plus的selectPage()分页查询没生效
热门推荐
Yangy的博客
10-24 1万+
热门系列： 程序人生，精彩抢先看 1、问题 最近尝试使用Mybatis-plus的selectPage()分页查询功能，然后发现按照API文档使用后，并没有生效。代码如下： List<Line> lineList = lineMapper.selectPage(new Page<>(1,6),query).getRecords(); 但是发现打印日志，并没有加上limit语句查询。（博主用的是Mysql数据库） 2、解决 ...
【MybatisPlus】MybatisPlus的selectPage()方法失效
RanLZ的博客
02-20 3619
selectPage分页失效
MyBatisPlus（SpringBoot版）功能说明
敢问路在何方，路在脚下
02-04 784
创建数据库mybatisplus_test，并创建t_user表 创建User类 1.1 常用注解 1.1.1 @TableName 该注解用于指定实体类对应的数据库表名。当实体类名与数据库表名不一致，或者实体类名不是数据库表名的驼峰写法时，您需要使用这个注解来明确指定表名。 @TableName注解的属性 value: 用户自定义表名，默认值"" schema：数据库名称，除非数据库使用了schema，否则不写 keepGlobalPrefix：此实体类映射的表是否使用在配置文件指定全局的tab
SpringBoot + MyBatis-Plus分页插件不生效解决办法
CURD工程师
11-14 4525
配置类 @Configuration public class MyBatisPlusConfig { @Bean public PaginationInterceptor paginationInterceptor() { return new PaginationInterceptor(); } } 测试方法 @Test public voi...
mybatis-plus 分页插件不生效，分页查询失效解决办法 ；使用mybatis-plus时候,routeDao.selectPage方法失效
weixin_45986454的博客
04-05 1981
标题：mybatis-plus 分页插件不生效，分页查询失效解决办法 ；使用mybatis-plus时候,routeDao.selectPage方法失效 将分页拦截器注入到spring中。 package com.itheima.config; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.P
MybatisPlus条件构造器selectPage方法示例代码
04-22
MybatisPlus条件构造器selectPage方法示例代码
fastadmin新建页面selectpage不生效问题
hj1043的博客
06-07 858
比如新建了fenpei页面之后，下拉框点击无反应，需要在对应的js文件做下绑定即可。另外值得主要的是：方法名不要大小写，否则也不生效。
【定位问题】Mybatis-plus的selectPage()分页查询不生效问题
qiuxuezhe_fei的博客
12-12 6401
Mybatis-plus的selectPage()分页查询不生效问题
MyBatis-Plus动态表名使用selectPage方法不生效问题解析与解决
学IT，找陈寒
12-01 4072
在实际应用中，我们有时需要动态地指定表名，而不是在SQL语句中写死表名。MyBatis-Plus提供了一种方便的方式来实现动态表名，通常通过注解@TableName和@SqlParser来完成。// 实体类字段在上述代码中，@TableName注解指定了表名为，这样在进行CRUD操作时，MyBatis-Plus就会自动使用该表名。MyBatis-Plus作为MyBatis的增强工具，提供了方便、高效的数据库操作方式。在使用动态表名时，特别是在分页查询中，可能会遇到selectPage方法。
深入了解：MybatisPlus条件构造器说明以及selectPage方法
牛肉胡辣汤
10-08 4783
MybatisPlus是一个优秀的ORM（对象关系映射）框架，提供了一系列强大的功能来简化数据库操作。其中，条件构造器和selectPage方法是MybatisPlus中非常常用的功能，可以方便地进行复杂的查询操作。本文将详细介绍MybatisPlus的条件构造器和selectPage方法的使用方法和注意事项，帮助读者更好地理解和应用这两个功能。本文介绍了MybatisPlus中的条件构造器和selectPage方法的使用方法和注意事项。
关于 SELECTPAGE 方法的使用
weixin_41629964的博客
12-15 7249
源码 /** * 根据 entity 条件，查询全部记录（并翻页） * * @param page 分页查询条件（可以为 RowBounds.DEFAULT） * @param queryWrapper 实体对象封装操作类（可以为 null） */ <P extends IPage<T>> P selectPage(P page, @Param(Constants.WRAPPER) W...
【select输入检索】下拉select支持输入检索之组件selectpage的属性应用详解
赏樱看雪撸代码
11-16 1715
select输入检索、下拉select支持输入检索之组件selectpage的属性应用详解、selectpage自定义
mybatis-plus动态设置表名
最新发布
02-06
### MyBatis-Plus 中动态设置表名的方法 #### 使用 SQL 注入器实现动态表名 为了实现在运行时动态改变表名的需求，可以通过自定义 SQL 注入器来完成。这种方式允许在不修改原有 Mapper 接口的情况下灵活调整查询语句中的表名[^1]。 ```java public class DynamicTableNameInjector extends AbstractMethod { @Override public MappedStatement injectMappedStatement(Class<?> mapperClass, Class<?> modelClass, TableInfo tableInfo) { SqlSource sqlSource = new RawSqlSource(configuration, String.format("SELECT * FROM %s WHERE id=#{id}", getDynamicTableName()), Object.class); return this.addSelectListMappedStatement(mapperClass, "selectByIdWithDynamicTable", sqlSource, null); } private String getDynamicTableName() { // 这里可以根据业务逻辑返回不同的表名 return "your_table_name"; } } ``` #### 自定义 Mapper 方法 另一种常见的做法是在具体的 Mapper 文件内重写 CRUD 操作并引入参数用于指定目标表格的名字。此法适用于那些希望保持对底层 SQL 更大控制权的应用程序开发人员。 ```xml <!-- UserMapper.xml --> <select id="selectUserByCustomTableName" parameterType="map" resultType="com.example.User"> SELECT * FROM ${tableName} <!-- 注意这里使用了${}而非#{},因为要直接替换字符串而不是作为预编译参数 --> WHERE id = #{userId}; </select> ``` ```java // 调用示例 Map<String, Object> params = Maps.newHashMap(); params.put("tableName", "users_2023"); params.put("userId", 1L); userMapper.selectUserByCustomTableName(params); ``` #### 利用 SpEL 表达式动态生成表名 对于 Spring Boot 用户来说，还可以借助于 Spring Expression Language (SpEL)，它可以在 XML 或者注解配置中嵌套表达式以计算出最终使用的表名[^2]。 ```xml <mapper namespace="com.baomidou.mybatisplus.samples.quickstart.mapper.UserMapper"> <select id="getUserById" parameterType="int" resultType="com.baomidou.mybatisplus.samples.quickstart.entity.User"> select * from users_#{T(java.lang.System).currentTimeMillis().toString().substring(0,4)} where id = #{id} </select> </mapper> ``` 以上三种方式均能有效地解决MyBatis-Plus项目里的动态表名需求，选择哪种取决于项目的具体情况和个人偏好。每种方案都有其适用范围，在实际工作中可根据团队的技术栈特点做出最合适的选择。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值