spring boot 2升级为spring boot 3中数据库连接池druid的问题
目录
ConfigurationClassPostProcessor
ConfigurationClassBeanDefinitionReader
MybatisPlusAutoConfiguration
ConditionEvaluator
OnBeanCondition
总结
近期给了一个任务，要求是对现有的 spring boot 2.x 项目进行升级，由于 spring boot 2.x 版本已经结束技术支持，所以需要升级为 spring boot 3.x
https://spring.io/blog/2023/11/23/spring-boot-2-7-18-available-now/
升级后报了一个 mybatis 的问题，如下
Caused by: java.lang.IllegalArgumentException: Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required
at org.springframework.util.Assert.notNull(Assert.java:172)
at org.mybatis.spring.support.SqlSessionDaoSupport.checkDaoConfig(SqlSessionDaoSupport.java:125)
at org.mybatis.spring.mapper.MapperFactoryBean.checkDaoConfig(MapperFactoryBean.java:73)
at org.springframework.dao.support.DaoSupport.afterPropertiesSet(DaoSupport.java:44)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1822)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1771)
... 49 common frames omitted即 SqlSessionFactory 没获取到，这个是操作 mybatis 必须要用的对象，这个竟然没有。
目前项目中使用的 mybatis 是增强版的 mybatis-plus，即在启动的时候启动 spring ioc 容器的时候没有找到 sqlSessionFactory 对象，鉴于是升级到新版本，考虑到版本变动大，所以自己新建了一个 spring boot 3 项目，来验证一下新的是否可以正常执行。
spring boot 3 项目中的 pom.xml 依赖
4.0.0
org.springframework.boot
spring-boot-starter-parent
3.2.0
com.example
mybatis-plus-spring-boot-3
0.0.1-SNAPSHOT
mybatis-plus-spring-boot-3
Demo project for Spring Boot
21
org.springframework.boot
spring-boot-starter
org.springframework.boot
spring-boot-starter-webflux
com.baomidou
mybatis-plus-spring-boot3-starter
3.5.5
com.mysql
mysql-connector-j
org.springframework.boot
spring-boot-maven-plugin
启动之后，发现正常。
那就是 mybatis-plus 哪里有问题了，跟进通过 AbstractApplicationContext#refresh() 跟进，发现在 ConfigurationClassPostProcessor#postProcessBeanDefinitionRegistry() 调用 ConfigurationClassBeanDefinitionReader#loadBeanDefinitions() 时出现了问题。
ConfigurationClassPostProcessor
ConfigurationClassBeanDefinitionReader
主要在 ConfigurationClassBeanDefinitionReader#loadBeanDefinitions() 中
其中，正常的 shouldSkip() 的返回值是 false，即执行接下来的 MybatisPlusAutoConfiguration$MapperScannerRegistrarNotFoundConfiguration 中的逻辑，将 MapperScannerConfigurer 类注册到 spring ioc 容器中。
MybatisPlusAutoConfiguration
看看 shouldSkip() 的 true 值是怎么来的
ConditionEvaluator
查看是如下的判断
这里有两个类，分别是 OnBeanCondition 和 OnClassCondition，其中 OnClassCondition 执行无异常，问题主要在 OnBeanCondition 上。
接下来对比一下看看两者变量赋值的区别
新项目没问题的
OnClassCondition
requiredPhase == null
true
requiredPhase == phase
false
(requiredPhase == null || requiredPhase == phase)
true
condition.matches(this.context, metadata)
true
!condition.matches(this.context, metadata)
false
(requiredPhase == null || requiredPhase == phase) && !condition.matches(this.context, metadata)
false
OnBeanCondition
requiredPhase == null
false
requiredPhase == phase
true
(requiredPhase == null || requiredPhase == phase)
true
condition.matches(this.context, metadata)
true
!condition.matches(this.context, metadata)
false
(requiredPhase == null || requiredPhase == phase) && !condition.matches(this.context, metadata)
false原项目有问题的
OnClassCondition
requiredPhase == null
true
requiredPhase == phase
false
(requiredPhase == null || requiredPhase == phase)
true
condition.matches(this.context, metadata)
true
!condition.matches(this.context, metadata)
false
(requiredPhase == null || requiredPhase == phase) && !condition.matches(this.context, metadata)
false
OnBeanCondition
requiredPhase == null
false
requiredPhase == phase
true
(requiredPhase == null || requiredPhase == phase)
true
condition.matches(this.context, metadata)
false
!condition.matches(this.context, metadata)
true
(requiredPhase == null || requiredPhase == phase) && !condition.matches(this.context, metadata)
true可以看到是 OnBeanCondition#matches() 返回有问题。
那就调试进去看一下
OnBeanCondition
发现在升级项目中变量 unmatchedTypes 中多了一个 javax.sql.DataSource 导致了返回结果为 false，进而导致了接下来的问题。
其中，isAllMatched() 的判断逻辑为 unmatchedAnnotations、unmatchedNames、unmatchedTypes 必须为空。
这就让我 想到了数据源的问题，项目中使用了阿里巴巴开源的连接池 druid，是不是没注册进这个对象？后面发现了引入的依赖中没有针对 spring boot 3 的自动装配进行处理。
在项目的 src/main/resources 下创建文件 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
内容如下
com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure启动正常。
后面又去 github 上看了一下
https://github.com/alibaba/druid
发现对于 spring boot 3 做了适配
https://github.com/alibaba/druid/releases/tag/1.2.20
可以看到，在 2023.10.08 日处理了这个问题。
看 maven 仓库，引入 1.20.0 及以上的版本即可。
com.alibaba
druid-spring-boot-3-starter
1.2.21
通过源码对比，发现 druid-spring-boot-starter 不兼容 druid-spring-boot-3-starter，druid-spring-boot-3-starter 是专门对 spring boot 3 进行了适配。
对比源码发现，1.2.18 和 1.2.19 对于 spring boot 3 适配都有问题。
总结
针对项目中的问题很多，尤其是 spring boot 3 带来的变化大，针对一些问题，需要从源码层次入手看问题。
之前整理的升级相关的文章
https://blog.csdn.net/zlpzlpzyd/article/details/134203560
https://blog.csdn.net/zlpzlpzyd/article/details/133160643
https://blog.csdn.net/zlpzlpzyd/article/details/132779246
参考链接
https://blog.csdn.net/weixin_43333483/article/details/131355109
https://www.cnblogs.com/jimmyhu/p/17300314.html
https://juejin.cn/post/7165884190028726308