spring boot版本升级遇到的一些问题

最新推荐文章于 2025-10-20 11:13:22 发布

原创最新推荐文章于 2025-10-20 11:13:22 发布 · 1.9k 阅读

26 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #后端 #java

java后端专栏收录该内容

24 篇文章

订阅专栏

本文描述了从nacos1.4.6升级到2.x版本过程中，涉及到的SpringBoot、SpringCloud及SpringCloudAlibaba版本调整，包括处理循环依赖、quartz数据源配置变更、跨域问题、依赖排除和Druid库的bug修复。

背景：由于项目需求，需要将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及以上，红框内是可选。
springboot版本
最终确定选择用*标记的最新版本。
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