最近因为各方面的起因在筹备降级 Spring Cloud 和 Spring Boot,通过一系列前置的调研和剖析,决定把 Spring Boot 相干版本从 2.1.6 降级到 2.7.5,Spring Cloud 相干版本从 Greenwich.SR1 降级为 2021.0.4。
降级蕴含根底的业务服务代码的降级革新适配,还有就是中间件一堆代码的革新,上周经验了一周的批改,用来测试的服务依然还没有跑起来,所以这篇文章我会记录下来这降级过程中的一些问题,因为反动仍未胜利,所以这是上篇。
1. hibernate-validator 包下的类报错
在 Spring Boot 2.3 版本之后,spring-boot-starter-web
中没有依赖 hibernate-validator。
解决方案:应用新的依赖。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
2. ApplicationEnvironmentPreparedEvent 类扭转
Spring Boot 2.4 版本之后,ApplicationEnvironmentPreparedEvent
构造函数新增了 ConfigurableBootstrapContext,业务代码还好,应该都用不上这个类,中间件代码应用到的中央都须要批改。
解决方案:批改代码。
public ApplicationEnvironmentPreparedEvent(ConfigurableBootstrapContext bootstrapContext,
SpringApplication application, String[] args, ConfigurableEnvironment environment) {super(application, args);
this.bootstrapContext = bootstrapContext;
this.environment = environment;
}
3. junit 依赖降级
降级后的 junit 版本默认是junit5
(我没有去确认是哪个版本产生了变动),降级之后包名产生了扭转,所有的测试用例都须要批改。
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
另外发现 Assert
类不存在了,能够改用Assertions
。
Assertions.assertNotNull(result);
解决方案:批改代码!
4. Spring Cloud 兼容问题
因为测试过程中先降级的 Spring Boot,发现 Spring Cloud 应用到的低版本代码不兼容,降级到文章结尾说的版本之后问题解决。
比方上面的 spring-cloud-context
启动时候报错。
5. SpringApplicationRunListener 类扭转
和第二个问题比拟相似,SpringApplicationRunListener
中这两个办法新增了 ConfigurableBootstrapContext,对应实现类都须要批改,这个应该无论在业务还是中间件代码中都应该有大量的应用。
解决方案:批改代码!
default void starting(ConfigurableBootstrapContext bootstrapContext) {}
default void environmentPrepared(ConfigurableBootstrapContext bootstrapContext,ConfigurableEnvironment environment) {}
6. ServerProperties 变更
spring-boot-autoconfigure
包下 ServerProperties 中的外部类 Tomcat 属性变更,获取最大线程数办法产生扭转。
原写法:serverProperties.getTomcat().getMaxThreads()
解决方案:serverProperties.getTomcat().getThreads().getMax()
7. spring-cloud-openfeign 中移除 ribbon 和 hystrix 依赖
Commit 地址:https://github.com/spring-clo…
这个提交把 spring-cloud-openfeign 外面对于 ribbon 和 hystrix 的依赖相干代码全副删除了,这个 commit 我找了一遍 issue 和 PR,都没有发现相干阐明,大佬间接删的,具体起因不分明为什么间接全删洁净了。
比方我的启动报错:
Caused by: java.lang.ClassNotFoundException: org.springframework.cloud.openfeign.ribbon.LoadBalancerFeignClient
解决方案:手动引入新的依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
<version>2.2.10.RELEASE</version>
</dependency>
8. bootstrap.properties/yml 配置文件不失效
依据 Spring Cloud 配置形式,发现很多业务的本地配置配置在 bootstrap.properties
中,新版本默认会不失效。
老版本中 spring.cloud.bootstrap.enabled
默认为 true。
新版本改过之后默认是 false 了,导致一堆配置不失效。
解决方案:手动设置spring.cloud.bootstrap.enabled=true
9. spring-cloud-netflix-eureka-client 中移除 ribbon 和 hystrix 依赖
和第七个问题差不多,spring-cloud-netflix-eureka-client
移除了 ribbon 和 hystrix 依赖,所以客户端默认不会有 ribbon 这些货色了。
解决方案:手动引入新的依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
<version>2.2.10.RELEASE</version>
</dependency>
10. spring-cloud-starter-alibaba-sentinel 版本不兼容
spring-cloud-starter-alibaba-sentinel
应用的是 2.1.3.RELEASE,和新版本存在兼容性问题,导致无奈启动,存在循环依赖问题。
报错信息:
org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration': Unsatisfied dependency expressed through method 'setConfigurers' parameter 0; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'com.alibaba.cloud.sentinel.SentinelWebAutoConfiguration': Unsatisfied dependency expressed through field 'sentinelWebInterceptorOptional'; nested exception is org.springframework.beans.factory.BeanCurrentlyInCreationException: Error creating bean with name 'com.alibaba.cloud.sentinel.SentinelWebAutoConfiguration': Requested bean is currently in creation: Is there an unresolvable circular reference?
解决方案:降级为以后 Spring Cloud 一样的版本。
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
<version>2021.0.4.0</version>
</dependency>
11. commons-pool2 兼容性报错
spring-boot-autoconfigure
2.7.5 版本中 JedisConnectionConfiguration
报错,起因在于咱们有的业务代码依赖中本人指定了 commons-pool2 的版本。
Description:
An attempt was made to call a method that does not exist. The attempt was made from the following location:
org.springframework.boot.autoconfigure.data.redis.JedisConnectionConfiguration.jedisPoolConfig(JedisConnectionConfiguration.java:114)
The following method did not exist:
redis.clients.jedis.JedisPoolConfig.setMaxWait(Ljava/time/Duration;)V
Action:
Correct the classpath of your application so that it contains compatible versions of the classes org.springframework.boot.autoconfigure.data.redis.JedisConnectionConfiguration and redis.clients.jedis.JedisPoolConfig
Git Issue:https://github.com/spring-pro…
看这个工夫很早就修改了,commons-pool2 在 2.8.1 版本后失落了一些办法。
解决方案:本人不要指定该包版本默认会应用 spring boot 的最新依赖,或者手动指定最新版本 2.11.1。
12. 循环依赖报错
spring-boot
2.6 版本之后禁止循环依赖,有的话启动会报错,报错信息和第十个问题是一样的,不同的是业务代码的报错而已。
解决方案:手动解决代码循环依赖问题或者设置属性 spring.main.allow-circular-references=true
。
13. spring-rabbit 版本兼容
降级之后,因为中间件封装了 rabbit 的一些性能,去掉了 spring-rabbit
的主动拆卸,导致基本上整个中间件包不可用,大量办法不兼容。
解决方案:全副用 2.7.5 版本的代码笼罩主动拆卸的逻辑。
小总结
看起来这些问题都只是一两句话的功夫,然而实际上花了大量的工夫在排查、找解决方案,还有把所有当初依赖的包版本从新筛查,批改包版本、从新打包测试版本,两头非人体验切实不是一两句话能说分明的,我感觉,做业务开发其实也挺好的。
目前反动还只是进行了一小步,还有更多的问题须要去解决,不过这个星期必须全副解决!!!