SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required()

  本篇文章为你整理了SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required()的详细内容,包含有 SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required,希望能帮助你了解 SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required。

   SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required

  
遇到了一个 Spring Boot 3 整合 MyBatis 的问题,然后解决了。当然,这其实不是个大问题,只是自己编码时遇到了,然后总结总结分享一下。如果有遇到类似问题的,可以参考一下。

  交代一下背景

  最近在熟悉 Spring Boot 3 版本的代码,开发过程中遇到了一些小坑,不过很快都解决了。然后就用 Spring Boot 3 版本写了几个小 demo,比如 Web 开发、连接数据库、使用 JdbcTemplate 操作数据库,编码和测试都非常顺利,虽然是从 Spring Boot 2.x 版本升级到 Spring Boot 3,但是没有感觉到太多差别。

  不过,在使用 Spring Boot 3 整合 MyBatis 时出现了一些问题,花了不少时间处理。

  使用的版本如下所示。

  Spring Boot 版本配置

  

 parent 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-parent /artifactId

   version 3.0.0-SNAPSHOT /version

   relativePath/ !-- lookup parent from repository --

   /parent

  

 

  MyBatis 版本配置

  

 dependency 

 

   groupId org.mybatis.spring.boot /groupId

   artifactId mybatis-spring-boot-starter /artifactId

   version 2.2.2 /version

   /dependency

  

 

  启动时直接报错,内容如下图所示。

  当然,异常信息挺多,比如无法创建 Bean 的异常等等,不过上面的几个异常并不是问题主因。这里我直接定位到最后的异常上,异常信息是:

  

Caused by: java.lang.IllegalArgumentException: Property sqlSessionFactory or sqlSessionTemplate are required

 

  

 

  跟入发生异常的地方,代码截图如下:

  问题原因也很明显,sqlSessionTemplate 对象是空的。

  当然,由于把 Spring Boot 版本升级到 3 了,所以会觉得有很大的可能是版本升级导致了问题。

  不过还是想自己查查问题,就依次检查了代码、数据库配置、MyBatis 配置,都没有发现哪里写错了,接着就没头绪了。之后又看了一下 MyBatis 自动配置的源码,通过 debug 模式看了下是不是有什么问题,在查看源码的过程中看到一个有意思的事情,SqlSessionFactoryBean 这个类直接报红了,如下图所示。

  为什么说有意思呢?

  正常情况下这个类肯定不会报错的。再去查询问题,发现 NestedIOException 这个类在 Spring 6 版本中直接删除了。对的,直接删除了。而 MyBatis 还没有同步更新,所以直接就报红了。

  如果真的是版本升级导致的,还真就暂时没法改,只能等 MyBatis 那边也发布新版本才行。除了 MyBatis 之外,如果使用 Spring Boot 3 直接整合 MyBatis-Plus 这种框架,那肯定也会报错的。

  另外,不止是 MyBatis 框架会出问题。像 Spring 6 这种直接嘎掉一些类的情况,如果其它框架里用到了一些 Spring 框架中的类,恰好也被嘎了。那么,升级到 Spring6 或者 Spring Boot 3 时,都得注意一下。

  解决问题:需要升级版本

  好的,排查自己的代码没发现问题。只有去古狗上看看有没有解决方案,搜了一圈,在 MyBatis 的开源仓库里看到了一个类似问题,解决方案也有,如下图所示。

  对的,使用 Spring Boot 3 版本整合 MyBatis 时,需要把 mybatis-spring-boot-starter 也升级。mybatis-spring-boot-starter 2.x 版本暂时还不适配 Spring Boot 3 版本,没辙。另外,由于还没正式发版,所以需要配置一个远程仓库。

  

 dependencies 

 

   !-- 引入 3.0.0-SNAPSHOT 版本的 mybatis-spring-boot-starter(未正式发版) --

   dependency

   groupId org.mybatis.spring.boot /groupId

   artifactId mybatis-spring-boot-starter /artifactId

   version 3.0.0-SNAPSHOT /version

   /dependency

   /dependencies

   repositories

   !-- 由于未正式发版,所以在Maven仓库里还搜不到,需要额外配置一个远程仓库 --

   repository

   id ossrh /id

   name OSS Snapshot repository /name

   url https://oss.sonatype.org/content/repositories/snapshots/ /url

   releases

   enabled false /enabled

   /releases

   snapshots

   enabled true /enabled

   /snapshots

   /repository

   /repositories

  

 

  2022 年 11 月26 日凌晨,mybatis-spring-boot 正式发布 3.0.0 版本,完全支持 Spring Boot 3 了。

  因此,现在就可以直接在pom.xml文件中引入正式版本了,不需要再使用SNAPSHOT版本了,代码如下:

  

 dependencies 

 

   !-- 引入 3.0.0 版本的 mybatis-spring-boot-starter(正式版) --

   dependency

   groupId org.mybatis.spring.boot /groupId

   artifactId mybatis-spring-boot-starter /artifactId

   version 3.0.0 /version

   /dependency

   /dependencies

  

 

  事情不大,本来不想单独写篇文章的,但是我有个预感,在项目中升级 Spring Boot 3 时还会有其它问题。不知道 Spring6 这次更新了多少东西,连 TM 的MyBatis、MyBatis-Plus 这种常用的框架都中招了。这些就慢慢整理吧,毕竟是大版本升级,难免会出现不兼容、等依赖更新的情况。确实没辙,等更新呗。

  如果这篇文章浪费了你的时间,先说声抱歉,你直接关掉网页就好。

  因为维护了几个 Spring Boot 的开源项目,Spring Boot 3 正式发版了,我也会及时更新版本、升级这几个 Spring Boot 实战项目。如果碰到了什么问题,也会及时分享出来。

  
 

  除注明转载/出处外,皆为作者原创,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文链接,否则保留追究法律责任的权利。

  
第三次,在困难和容易之间,它选择了容易;
 

  第四次,它犯了错,却借由别人也会犯错来宽慰自己;
 

  第五次,它自由软弱,却把它认为是生命的坚韧;
 

  第六次,当它鄙夷一张丑恶的嘴脸时,却不知那正是自己面具中的一副;
 

  第七次,它侧身于生活的污泥中虽不甘心,却又畏首畏尾。

  以上就是SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required()的详细内容,想要了解更多 SpringBoot3整合MyBatis报错:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required的内容,请持续关注盛行IT软件开发工作室。

郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。

留言与评论(共有 条评论)
   
验证码: