1. 从一次真实的报错说起:我的SpringBoot3项目启动失败了
那天下午,我正兴致勃勃地准备启动一个全新的SpringBoot3项目。这个项目我打算用最新的技术栈,SpringBoot 3.1.0,搭配Mybatis来做数据持久层。依赖一加,配置文件一写,鼠标一点“运行”,满心期待控制台出现那个熟悉的“Started Application in X seconds”。
结果,迎头就是一盆冷水。控制台刷出了一大片红色的错误日志,项目根本启动不起来。核心的错误信息就指向那一行:
Caused by: java.lang.IllegalArgumentException: Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required
我当时的第一反应是:“不对啊,我的配置明明都写了。” application.yml 里数据库连接、Mybatis的mapper-locations都配置得好好的,@MapperScan 注解也加在了启动类上。这种错误通常发生在你手动配置SqlSessionFactory Bean的时候漏了,但我用的是SpringBoot的自动配置,按理说不应该啊。
我又仔细检查了堆栈跟踪,发现错误最终抛出的位置在 org.mybatis.spring.support.SqlSessionDaoSupport.checkDaoConfig。这说明Mybatis在初始化Mapper接口的时候,发现它依赖的 sqlSessionFactory 或 sqlSessionTemplate 这两个核心Bean是空的。可SpringBoot的自动配置不就是负责创建这些Bean的吗?问题出在哪?
我带着疑惑去翻看了项目的 pom.xml。当我看到Mybatis的版本时,心里咯噔一下。我用的版本是:
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>
这个版本号让我瞬间想起了什么。SpringBoot 3是一个大版本升级,它基于Spring Framework 6。而Spring 6本身做了很多“破坏性更新”,移除了一些过时的类和API。我隐约记得,Mybatis-Spring-Boot-Starter在3.0.0版本之前,都是为SpringBoot 2.x(对应Spring 5)设计的。一个为Spring 5设计的旧版本starter,跑在基于Spring 6的SpringBoot 3上,不出问题才怪呢。
这其实就是典型的版本不兼容问题。技术栈升级,尤其是大版本跨越,就像给房子换地基,如果上面的建材(第三方依赖)不跟着适配,房子肯定要出问题。接下来,我们就来彻底搞清楚这个问题的来龙去脉,并手把手把它解决掉。
2. 刨根问底:为什么SpringBoot3和旧版Mybatis会“打架”?
要解决问题,光知道“版本不对”还不够,我们得明白它们到底是怎么“打起来”的。这样以后遇到类似的兼容性问题,你也能自己分析。
2.1 SpringBoot 3 带来的核心变化:Spring Framework 6
SpringBoot 3.0 最大的一个变化就是将底层框架从 Spring Framework 5 升级到了 Spring Framework 6。这可不是简单的版本号+1,而是一次为了拥抱Java生态最新标准(特别是Java 17+和Jakarta EE 9+)的重大革新。
其中最关键的一点是:Spring Framework 6 将默认的包命名空间从 javax.*
350



被折叠的 条评论
为什么被折叠?



