我服了!SpringBoot 升级后这服务我一个星期都没跑起来!(上)
最近由于各方面的原因在准备升级 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。
解决方案:使用新的依赖。
2. ApplicationEnvironmentPreparedEvent 类改变
Spring Boot 2.4 版本之后,ApplicationEnvironmentPreparedEvent
构造函数新增了 ConfigurableBootstrapContext,业务代码还好,应该都用不上这个类,中间件代码使用到的地方都需要修改。
解决方案:修改代码。
![](https://static001.geekbang.org/infoq/b2/b2e2b64353742af04574a010dd90a414.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
3. junit 依赖升级
升级后的 junit 版本默认是junit5
(我没有去确认是哪个版本发生了变化),升级之后包名发生了改变,所有的测试用例都需要修改。
另外发现Assert
类不存在了,可以改用Assertions
。
解决方案:修改代码!
4. Spring Cloud 兼容问题
由于测试过程中先升级的 Spring Boot,发现 Spring Cloud 使用到的低版本代码不兼容,升级到文章开头说的版本之后问题解决。
比如下面的 spring-cloud-context
启动时候报错。
![](https://static001.geekbang.org/infoq/62/62aa6dec2a39146d7b7a28c1ba6d1612.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
5. SpringApplicationRunListener 类改变
和第二个问题比较类似,SpringApplicationRunListener
中这两个方法新增了 ConfigurableBootstrapContext,对应实现类都需要修改,这个应该无论在业务还是中间件代码中都应该有大量的使用。
解决方案:修改代码!
6. ServerProperties 变更
spring-boot-autoconfigure
包下 ServerProperties 中的内部类 Tomcat 属性变更,获取最大线程数方法发生改变。
原写法:serverProperties.getTomcat().getMaxThreads()
解决方案:serverProperties.getTomcat().getThreads().getMax()
7. spring-cloud-openfeign 中移除 ribbon 和 hystrix 依赖
这个提交把 spring-cloud-openfeign 里面关于 ribbon 和 hystrix 的依赖相关代码全部删除了,这个 commit 我找了一遍 issue 和 PR,都没有发现相关说明,大佬直接删的,具体原因不清楚为什么直接全删干净了。
比如我的启动报错:
解决方案:手动引入新的依赖。
8. bootstrap.properties/yml 配置文件不生效
根据 Spring Cloud 配置方式,发现很多业务的本地配置配置在 bootstrap.properties
中,新版本默认会不生效。
老版本中 spring.cloud.bootstrap.enabled
默认为 true。
![](https://static001.geekbang.org/infoq/67/67a6cd0a693560a5d2b6c692ef06e6d1.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
新版本改过之后默认是 false 了,导致一堆配置不生效。
![](https://static001.geekbang.org/infoq/7c/7ca35618e8331c0f59e4ce05116861c9.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
![](https://static001.geekbang.org/infoq/30/30fb9a4ce539b6845148914d86bfeef1.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
解决方案:手动设置spring.cloud.bootstrap.enabled=true
9. spring-cloud-netflix-eureka-client 中移除 ribbon 和 hystrix 依赖
和第七个问题差不多,spring-cloud-netflix-eureka-client
移除了 ribbon 和 hystrix 依赖,所以客户端默认不会有 ribbon 这些东西了。
解决方案:手动引入新的依赖。
10. spring-cloud-starter-alibaba-sentinel 版本不兼容
spring-cloud-starter-alibaba-sentinel
使用的是 2.1.3.RELEASE ,和新版本存在兼容性问题,导致无法启动,存在循环依赖问题。
报错信息:
解决方案:升级为当前 Spring Cloud 一样的版本。
11. commons-pool2 兼容性报错
spring-boot-autoconfigure
2.7.5 版本中 JedisConnectionConfiguration
报错,原因在于我们有的业务代码依赖中自己指定了 commons-pool2 的版本。
![](https://static001.geekbang.org/infoq/cc/cc80aa29d296582716da5ad72d04ef72.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
Git Issue :https://github.com/spring-projects/spring-boot/issues/27642
看这个时间很早就修正了,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 版本的代码覆盖自动装配的逻辑。
![](https://static001.geekbang.org/infoq/ad/adede60010b26db007f30442cdd2e284.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
小总结
看起来这些问题都只是一两句话的功夫,但是实际上花了大量的时间在排查、找解决方案,还有把所有现在依赖的包版本重新筛查,修改包版本、重新打包测试版本,中间非人体验实在不是一两句话能说清楚的,我觉得,做业务开发其实也挺好的。
目前革命还只是进行了一小步,还有更多的问题需要去解决,不过这个星期必须全部解决!!!
版权声明: 本文为 InfoQ 作者【艾小仙】的原创文章。
原文链接:【http://xie.infoq.cn/article/ba7a5fdc1713f5df7b8871d28】。文章转载请联系作者。
评论