背景:由于项目需求,需要将nacos 1.4.6版本升级到2.x版本,由此引发的springboot、springcloud、springcloud Alibaba一系列版本变更。
旧版本分别为:
Spring Boot 2.3.5.RELEASE
Spring Cloud Hoxton.SR9
Spring Cloud Alibaba 2.2.6.RELEASE
一、版本选择
1、springboot2.x.x及以下使用jdk11、jdk8都可以,springboot3.x.x最低要求jdk17。首先确定springboot版本需要支持jdk8,即需要springboot2.x.x。
2、根据项目需求,选择合适的版本。
参考:Git版本说明网址:(组件版本以及依赖关系)
例:要考虑支持nacos2.x,所以红框内是可选。
Spring Cloud Alibaba 需要在2.2.8.RELEASE及以上,红框内是可选。
最终确定选择用*标记的最新版本。
Spring Boot 2.6.13
Spring Cloud 2021.0.5
Spring Cloud Alibaba 2021.0.5.0
nacos 2.2.0
二、奇奇怪怪的坑
1、循环依赖
springboot升级为2.6.13后项目启动报错:
Action:
Relying upon circular references is discouraged and they are prohibited by default. Update your application to remove the dependency cycle between beans. As a last resort, it may be possible to break the cycle automatically by setting spring.main.allow-circular-references to true.
出现的bug大概意思是:不鼓励依赖循环引用,默认情况下是禁止的。更新您的应用程序以删除 bean 之间的依赖循环。作为最后的手段,可以通过将 spring.main.allow-circular-references 设置为 true 来自动中断循环。
没有特殊处理代码,最后选择了修改yml配置文件,按照提示添加如下配置
spring:main:allow-circular-references:true
2、quartz数据源配置
springboot升级为2.6.13后项目启动报错:
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name ‘quartzScheduler’ defined in class path resource [org/springframework/boot/autoconfigure/quartz/QuartzAutoConfiguration.class]: Invocation of init method failed; nested exception is org.quartz.SchedulerConfigException: DataSource name not set.
报错原因:
spring-boot-starter-quartz 2.5.6 之前使用org.quartz.impl.jdbcjobstore.JobStoreTX定义quartz的默认数据源支持,quartz.properties如下
org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX
2.5.6的版本后将不再支持以上方式进行配置默认数据源,需改为如下配置
org.quartz.jobStore.class=org.springframework.scheduling.quartz.LocalDataSourceJobStore
3、跨域问题
项目启动成功,前端访问报错:
去网上查了原因后,是升级后spring的CorsFilter类针对CorsConfiguration新增了校验,最后修改方案是继续使用CorsFilter,使用官方推荐的allowedOriginPatterns即可,如下
// corsConfiguration.addAllowedOrigin("*");
corsConfiguration.addAllowedOriginPattern("*");
想看详细涉及源码的可以看这篇:记一次spring boot升级跨域问题的坑
4、版本依赖排除
升级后sentinel相关提示找不到依赖错误,cant reslove fastjson:1.2.83_noneautotype
排除当前使用的版本,引用maven仓库中有的版本
5、Druid的一个bug
抛出异常:maxEvictableIdleTimeMillis must be grater than minEvictableIdleTimeMillis。
Druid-1.1.10 升级为 Druid-1.1.22
具体详细可参考这篇文章:Druid的一个Bug