mybatis升級(jí)mybatis-plus時(shí)踩到的一些坑

更新時(shí)間：2020年09月11日 10:08:15 作者：linyb極客之路

這篇文章主要給大家介紹了關(guān)于mybatis升級(jí)mybatis-plus時(shí)踩到的一些坑，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

前言

最近使用RuoYi-Vue來(lái)做后臺(tái)管理腳手架。RuoYi-Vue 是一個(gè) Java EE 企業(yè)級(jí)快速開(kāi)發(fā)平臺(tái)，基于經(jīng)典技術(shù)組合（Spring Boot、Spring Security、MyBatis、Jwt、Vue），內(nèi)置模塊如：部門(mén)管理、角色用戶、菜單及按鈕授權(quán)、數(shù)據(jù)權(quán)限、系統(tǒng)參數(shù)、日志管理、代碼生成等。在線定時(shí)任務(wù)配置；支持集群，支持多數(shù)據(jù)源。其官方文檔如下

http://doc.ruoyi.vip/

感興趣的朋友，可以點(diǎn)鏈接查看。這個(gè)平臺(tái)目前的orm框架是mybatis，而項(xiàng)目組的orm框架是mybatis-plus。為了統(tǒng)一技術(shù)棧，項(xiàng)目組就決定把若依的orm框架升級(jí)為mybatis-plus。因?yàn)橹熬陀羞^(guò)把mybatis升級(jí)為mybatis-plus的經(jīng)驗(yàn)，就感覺(jué)這個(gè)升級(jí)是很簡(jiǎn)單。但是在改造后，運(yùn)行程序卻報(bào)了形如下異常

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

排查

從異常的字面意思是說(shuō)，F(xiàn)IleMapper中的insert方法沒(méi)有綁定。查看FileMapper.xml配置，確實(shí)沒(méi)有發(fā)現(xiàn)綁定insert這個(gè)sql語(yǔ)句塊。那是否加上insert的sql語(yǔ)句塊，就能解決問(wèn)題？加上確實(shí)是能解決問(wèn)題。

但如果用過(guò)mybatis-plus的朋友，應(yīng)該會(huì)知道，mybatis-plus中BaseMapper已經(jīng)幫我們封裝好了一系列的單表增刪改查，我們無(wú)需寫(xiě)配置，就可以實(shí)現(xiàn)單表增刪改查。所以在xml配置insert是治標(biāo)不治本。

那要如何排查呢？

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

利用maven helper插件包沖突

從圖可以看出不是包沖突引起的。

注：因?yàn)橹俺赃^(guò)包沖突的虧，因此在把若依的orm改成mybatis-plus之前，就已經(jīng)去除跟mybatis相關(guān)的 jar沖突了

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

我們引入的必須是

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

而不是

import com.baomidou.mybatisplus.mapper.BaseMapper;

不過(guò)出現(xiàn)這個(gè)問(wèn)題，通常也是引入不同版本的mybatis-plus jar才會(huì)出現(xiàn)。如果你是只用3+以上版本，他引入就只有

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

方向三：通用方法（斷點(diǎn)調(diào)試）

其實(shí)代碼排查最怕就是異常棧被吃了，如果有異常信息，排查方向相對(duì)比較好找。比如這個(gè)異常，其異常棧信息為

Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.lybgeek.admin.file.mapper.FileMapper.insert
  at org.apache.ibatis.binding.MapperMethod$SqlCommand.<init>(MapperMethod.java:235)
  at org.apache.ibatis.binding.MapperMethod.<init>(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)

我們從異常棧信息，我們可以知道這個(gè)異常從

org.apache.ibatis.binding.MapperMethod

這個(gè)類拋出，于是我們可以把斷點(diǎn)先設(shè)置到這邊。通過(guò)源碼我們可以得知org.apache.ibatis.mapping.MappedStatement空了，導(dǎo)致報(bào)了如上異常，而MappedStatement又是由

org.apache.ibatis.session.Configuration

提供。而Configuration是通過(guò)

org.apache.ibatis.session.SqlSessionFactory

進(jìn)行設(shè)置。然后繼續(xù)排查，就會(huì)發(fā)現(xiàn)

com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfiguration

這個(gè)自動(dòng)裝配類。里面有這么一段代碼

  @Bean
  @ConditionalOnMissingBean
  public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
    // TODO 使用 MybatisSqlSessionFactoryBean 而不是 SqlSessionFactoryBean
    MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean();
    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 對(duì)源碼做了一定的修改(因?yàn)樵创a適配了老舊的mybatis版本,但我們不需要適配)
    Class<? extends LanguageDriver> 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 此處必為非 NULL
    GlobalConfig 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 設(shè)置 GlobalConfig 到 MybatisSqlSessionFactoryBean
    factory.setGlobalConfig(globalConfig);
    return factory.getObject();
  }

作者在注釋上都寫(xiě)了，要用

MybatisSqlSessionFactoryBean 而不是 SqlSessionFactoryBean

于是查看若依代碼，發(fā)現(xiàn)在若依中的mybatis配置類中有配置如下代碼片段

 @Bean
  public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception
  {
    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);

    final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
    sessionFactory.setDataSource(dataSource);
    sessionFactory.setTypeAliasesPackage(typeAliasesPackage);
    sessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver().getResources(mapperLocations));
    sessionFactory.setConfigLocation(new DefaultResourceLoader().getResource(configLocation));
    return sessionFactory.getObject();
  }

從MybatisPlusAutoConfiguration的源碼中，我們可以得知，當(dāng)項(xiàng)目已經(jīng)有配置SqlSessionFactory。mybatis-plus將不會(huì)自動(dòng)幫我們注入SqlSessionFactory，而使用我們自己定義的SqlSessionFactory。而若依項(xiàng)目配置的SqlSessionFactory不是MybatisSqlSessionFactoryBean

修復(fù)

1、方法一

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

2、方法二

去掉項(xiàng)目中sqlSessionFactory。這樣mybatis-plus就會(huì)自動(dòng)幫我們注入sqlSessionFactory

總結(jié)

可能有朋友會(huì)覺(jué)得遇到異常問(wèn)題，直接通過(guò)搜索引擎找答案不就可以了。這確實(shí)是一個(gè)挺好的方法，但有時(shí)候可能搜索半天都沒(méi)找到答案，我們就可以通過(guò)異常信息棧、以及調(diào)試線程棧，就可以得出一些比較有用的信息。出現(xiàn)異常并不可怕，可怕的是出了問(wèn)題，異常日志信息被吞，都不知道從何排查。最后安利一下若依這個(gè)腳手架，管理后臺(tái)開(kāi)發(fā)神器，誰(shuí)用誰(shuí)知道

到此這篇關(guān)于mybatis升級(jí)mybatis-plus時(shí)踩到的一些坑的文章就介紹到這了,更多相關(guān)mybatis升級(jí)mybatis-plus踩坑內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: