mybatis升级为mybatis-plus踩到的坑

https://www.cnblogs.com/linyb-geek/p/13647327.html

前言

最近使用RuoYi-Vue来做后台管理脚手架。RuoYi-Vue 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring Security、MyBatis、Jwt、Vue），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置；支持集群，支持多数据源。其官方文档如下

http://doc.ruoyi.vip/

感兴趣的朋友，可以点链接查看。这个平台目前的orm框架是mybatis，而项目组的orm框架是mybatis-plus。为了统一技术栈，项目组就决定把若依的orm框架升级为mybatis-plus。因为之前就有过把mybatis升级为mybatis-plus的经验，就感觉这个升级是很简单。但是在改造后，运行程序却报了形如下异常

Invalid boundstatement(not found): com.lybgeek.admin.file.mapper.FileMapper.insert

排查

从异常的字面意思是说，FIleMapper中的insert方法没有绑定。查看FileMapper.xml配置，确实没有发现绑定insert这个sql语句块。那是否加上insert的sql语句块，就能解决问题？加上确实是能解决问题。

但如果用过mybatis-plus的朋友，应该会知道，mybatis-plus中BaseMapper已经帮我们封装好了一系列的单表增删改查，我们无需写配置，就可以实现单表增删改查。所以在xml配置insert是治标不治本。

那要如何排查呢？

1、方向一：是否是包冲突引起？

利用maven helper插件包冲突

从图可以看出不是包冲突引起的。

注： 因为之前吃过包冲突的亏，因此在把若依的orm改成mybatis-plus之前，就已经去除跟mybatis相关的 jar冲突了

方向二：是不是引入不同类包的BaseMapper

我们引入的必须是

importcom.baomidou.mybatisplus.core.mapper.BaseMapper;

而不是

importcom.baomidou.mybatisplus.mapper.BaseMapper;

不过出现这个问题，通常也是引入不同版本的mybatis-plus jar才会出现。如果你是只用3+以上版本，他引入就只有

importcom.baomidou.mybatisplus.core.mapper.BaseMapper;

方向三：通用方法（断点调试）

其实代码排查最怕就是异常栈被吃了，如果有异常信息，排查方向相对比较好找。比如这个异常，其异常栈信息为

Caused by: org.apache.ibatis.binding.BindingException:Invalid boundstatement(not found): com.lybgeek.admin.file.mapper.FileMapper.insertat org.apache.ibatis.binding.MapperMethod$SqlCommand.(MapperMethod.java:235)at org.apache.ibatis.binding.MapperMethod.(MapperMethod.java:53)at org.apache.ibatis.binding.MapperProxy.lambda$cachedInvoker$0(MapperProxy.java:107)at java.util.concurrent.ConcurrentHashMap.computeIfAbsent(ConcurrentHashMap.java:1660)at org.apache.ibatis.binding.MapperProxy.cachedInvoker(MapperProxy.java:94)at org.apache.ibatis.binding.MapperProxy.invoke(MapperProxy.java:85)at com.sun.proxy.$Proxy129.insert(Unknown Source)at com.baomidou.mybatisplus.extension.service.IService.save(IService.java:59)at com.baomidou.mybatisplus.extension.service.IService$$FastClassBySpringCGLIB$$f8525d18.invoke(<generated>)at org.springframework.cglib.proxy.MethodProxy.invoke(MethodProxy.java:218)

我们从异常栈信息，我们可以知道这个异常从

org.apache.ibatis.binding.MapperMethod

这个类抛出，于是我们可以把断点先设置到这边。通过源码我们可以得知org.apache.ibatis.mapping.MappedStatement空了，导致报了如上异常，而MappedStatement又是由

org.apache.ibatis.session.Configuration

提供。而Configuration是通过

org.apache.ibatis.session.SqlSessionFactory

进行设置。然后继续排查，就会发现

com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfiguration

这个自动装配类。里面有这么一段代码

@Bean@ConditionalOnMissingBeanpublicSqlSessionFactorysqlSessionFactory(DataSource dataSource)throwsException{// TODO 使用 MybatisSqlSessionFactoryBean 而不是 SqlSessionFactoryBeanMybatisSqlSessionFactoryBean factory =newMybatisSqlSessionFactoryBean();        factory.setDataSource(dataSource);        factory.setVfs(SpringBootVFS.class);if(StringUtils.hasText(this.properties.getConfigLocation())) {            factory.setConfigLocation(this.resourceLoader.getResource(this.properties.getConfigLocation()));        }        applyConfiguration(factory);if(this.properties.getConfigurationProperties() !=null) {            factory.setConfigurationProperties(this.properties.getConfigurationProperties());        }if(!ObjectUtils.isEmpty(this.interceptors)) {            factory.setPlugins(this.interceptors);        }if(this.databaseIdProvider !=null) {            factory.setDatabaseIdProvider(this.databaseIdProvider);        }if(StringUtils.hasLength(this.properties.getTypeAliasesPackage())) {            factory.setTypeAliasesPackage(this.properties.getTypeAliasesPackage());        }if(this.properties.getTypeAliasesSuperType() !=null) {            factory.setTypeAliasesSuperType(this.properties.getTypeAliasesSuperType());        }if(StringUtils.hasLength(this.properties.getTypeHandlersPackage())) {            factory.setTypeHandlersPackage(this.properties.getTypeHandlersPackage());        }if(!ObjectUtils.isEmpty(this.typeHandlers)) {            factory.setTypeHandlers(this.typeHandlers);        }        Resource[] mapperLocations =this.properties.resolveMapperLocations();if(!ObjectUtils.isEmpty(mapperLocations)) {            factory.setMapperLocations(mapperLocations);        }// TODO 对源码做了一定的修改(因为源码适配了老旧的mybatis版本,但我们不需要适配)Class defaultLanguageDriver =this.properties.getDefaultScriptingLanguageDriver();if(!ObjectUtils.isEmpty(this.languageDrivers)) {            factory.setScriptingLanguageDrivers(this.languageDrivers);        }        Optional.ofNullable(defaultLanguageDriver).ifPresent(factory::setDefaultScriptingLanguageDriver);// TODO 自定义枚举包if(StringUtils.hasLength(this.properties.getTypeEnumsPackage())) {            factory.setTypeEnumsPackage(this.properties.getTypeEnumsPackage());        }// TODO 此处必为非 NULLGlobalConfig globalConfig =this.properties.getGlobalConfig();// TODO 注入填充器this.getBeanThen(MetaObjectHandler.class, globalConfig::setMetaObjectHandler);// TODO 注入主键生成器this.getBeanThen(IKeyGenerator.class, i -> globalConfig.getDbConfig().setKeyGenerator(i));// TODO 注入sql注入器this.getBeanThen(ISqlInjector.class, globalConfig::setSqlInjector);// TODO 注入ID生成器this.getBeanThen(IdentifierGenerator.class, globalConfig::setIdentifierGenerator);// TODO 设置 GlobalConfig 到 MybatisSqlSessionFactoryBeanfactory.setGlobalConfig(globalConfig);returnfactory.getObject();    }

作者在注释上都写了，要用

MybatisSqlSessionFactoryBean 而不是 SqlSessionFactoryBean

于是查看若依代码，发现在若依中的mybatis配置类中有配置如下代码片段

@BeanpublicSqlSessionFactorysqlSessionFactory(DataSource dataSource)throwsException{        String typeAliasesPackage = env.getProperty("mybatis.type-aliases-package");        String mapperLocations = env.getProperty("mybatis.mapper-locations");        String configLocation = env.getProperty("mybatis.config-location");        typeAliasesPackage = setTypeAliasesPackage(typeAliasesPackage);        VFS.addImplClass(SpringBootVFS.class);finalSqlSessionFactoryBean sessionFactory =newSqlSessionFactoryBean();        sessionFactory.setDataSource(dataSource);        sessionFactory.setTypeAliasesPackage(typeAliasesPackage);        sessionFactory.setMapperLocations(newPathMatchingResourcePatternResolver().getResources(mapperLocations));        sessionFactory.setConfigLocation(newDefaultResourceLoader().getResource(configLocation));returnsessionFactory.getObject();    }

从MybatisPlusAutoConfiguration的源码中，我们可以得知，当项目已经有配置SqlSessionFactory。mybatis-plus将不会自动帮我们注入SqlSessionFactory，而使用我们自己定义的SqlSessionFactory。而若依项目配置的SqlSessionFactory不是MybatisSqlSessionFactoryBean

修复

1、方法一

把mybatis的SqlSessionFactoryBean替换成mybatis-plus的MybatisSqlSessionFactoryBean

2、方法二

去掉项目中sqlSessionFactory。这样mybatis-plus就会自动帮我们注入sqlSessionFactory

总结

可能有朋友会觉得遇到异常问题，直接通过搜索引擎找答案不就可以了。这确实是一个挺好的方法，但有时候可能搜索半天都没找到答案，我们就可以通过异常信息栈、以及调试线程栈，就可以得出一些比较有用的信息。出现异常并不可怕，可怕的是出了问题，异常日志信息被吞，都不知道从何排查。最后安利一下若依这个脚手架，管理后台开发神器，谁用谁知道

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 214,837评论 6赞 496
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 91,551评论 3赞 389
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 160,417评论 0赞 350
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 57,448评论 1赞 288
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,524评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,554评论 1赞 293
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,569评论 3赞 414
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,316评论 0赞 270
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,766评论 1赞 307
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,077评论 2赞 330
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,240评论 1赞 343
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,912评论 5赞 338
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,560评论 3赞 322
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,176评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,425评论 1赞 268
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,114评论 2赞 366
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,114评论 2赞 352