Springboot项目升级2.2.x升至2.7.x的示例代码

 更新时间:2023年09月19日 09:16:09   作者:Box_clf  
本文主要介绍了Springboot项目升级2.2.x升至2.7.x的示例代码,会有很多的坑,具有一定的参考价值,感兴趣的可以了解一下

依赖管理

spring-boot-starter-parent 升级为2.7.1

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
<!--        升级为2.7.x的版本-->
    <version>2.7.1</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

兼容老的配置文件格式,spring提供了专门的依赖进行兼容,但是建议还是在升级能成功运行之后进行配置的同步修改

<!--        升级2.7后支持yml环境变量名兼容-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

如果使用了bootstrap.yml文件,升级之后默认是不会使用bootstrap.yml了,所以可能会导致启动之后配置没有生效,需要引入依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
    <version>3.0.4</version>
</dependency>

配置修改

2.7.x不会处理循环依赖问题,需要手动配置修改application.yml添加配置 spring.main.allow-circular-references

如果有nacos的使用,版本替换为:

<!-- https://mvnrepository.com/artifact/com.alibaba.cloud/spring-cloud-starter-alibaba-nacos-config -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2021.0.4.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.alibaba.cloud/spring-cloud-starter-alibaba-nacos-discovery -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2021.0.4.0</version>
</dependency>

同时需要支持yml配置,添加 spring.config.import

spring:
  profiles:
    active: "@profileActive@"
  application:
    name: saas
  cloud:
    nacos:
      server-addr: xx.xx.xx.xx:8848
      discovery:
        server-addr: xx.xx.xx.xx:8848
        namespace: f8f5c0c4-adc9-4c37-be6b-ddc
      config:
        server-addr: xx.xx.xx.xx:8848  #配置中心
        file-extension: yaml   #配置文件后缀名   dataId = application.name  +  file-extension
        namespace: f8f5c0c4-adc9-4c37-be6b-ddc
  config:
    import:
      - optional:nacos:${spring.application.name}-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension} #配置中心

报错问题定位思路

启动报错:

Web application could not be started as there was no org.springframework.boot.web.servlet.server.ServletWebServerFactory bean defined in the context.

最开始搜索报错,很多网上说的一般都是忘记加注解 @SpringBootApplication ,或者没有引入依赖:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

但是检查并没有遗漏。开始根据问题本身进行定位。

报错本身就是没有找到ServletWebServerFactory,那么思路就是检查xxxxxxxConfiguration中的代码是否正常执行,这里就是 org.springframework.boot.autoconfigure.web.servlet.ServletWebServerFactoryConfiguration

因为是Tomcat方式启动所以只需要关心 tomcatServletWebServerFactory 方法

这里我设置了debug的方式但是并没有走到这里

再次全局搜索怀疑可能是自动装配的类 org.springframework.boot.autoconfigure.web.servlet.ServletWebServerFactoryAutoConfiguration 有问题

再次尝试debug发现依然没有走到,继续思考查看类上方相关的Conditional注解条件是否满足,猜测可能是 @ConditionalOnWebApplication(type = Type.SERVLET) 不满足

点进注解查看

继续查看对应的 org.springframework.boot.autoconfigure.condition.OnWebApplicationCondition ,搜索刚才的相关的 SERVLET ,继续debug发现type为null直接返回了

继续查找调用的地方进行debug发现 autoConfigurationMetadata 传入的就有问题,很多value都是空字符串

继续定位到上级调用,发现传入的数据依然和上面一样存在问题

继续跟踪定位,终于调到了我们自己写的代码了

继续查看上级调用,发现这个类是我们自己拷贝出来的Springboot内部的类,做了一些自定义的改造

这里就说明,可能是从低版本的Springboot中拷贝出来的,但是升级到2.7.x之后可能存在对应的逻辑变化,所以需要对比一下,大概是哪些代码不一致

Ctrl+A全选Ctrl+C复制我们自己写的代码,然后跳进内部的 AutoConfigurationImportSelector 再进行比较

这里发现我们自己的代码少了一行

ImportCandidates.load(AutoConfiguration.class, getBeanClassLoader()).forEach(configurations::add);

根据断言可以知道对应的这段代码不仅是读取了 META-INF/spring.factories 中的自动装配信息,还读取了 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 中的自动装配的bean

最后查看了包结构,确实如此,升级后 META-INF/spring.factories 没有了 ServletWebServerFactoryAutoConfiguration 而是放到了 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 中。最后解决就是复制对应的代码到自定义的类中,支持 imports 中的自动装配

到此这篇关于Springboot项目升级2.2.x升至2.7.x的示例代码的文章就介绍到这了,更多相关Springboot 升级2.2.x升至2.7.x内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • java web实现邮箱激活与忘记密码

    java web实现邮箱激活与忘记密码

    这篇文章主要为大家详细介绍了java web实现邮箱激活与忘记密码、重置密码,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-02-02
  • Java读取DWG文件的完整步骤

    Java读取DWG文件的完整步骤

    DWG 是 AutoCAD 的专有二进制格式,直接解析难度大,通过开源库 Teigha File Converter(现更名 ODA File Converter)可实现格式转换,间接读取数据,本文给大家介绍了Java读取DWG文件的完整步骤,需要的朋友可以参考下
    2025-11-11
  • java数据结构基础:单链表与双向链表

    java数据结构基础:单链表与双向链表

    这篇文章主要为大家详细介绍了java实现单链表、双向链表的相关资料,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 使用profiles进行多环境配置的代码实现

    使用profiles进行多环境配置的代码实现

    在项目开发的过程中会用到多个环境,为了便于开发使用,通常需要使用profiles进行多环境配置,所以本文给大家介绍了使用profiles进行多环境配置的代码实现,需要的朋友可以参考下
    2024-02-02
  • Spring Boot集成Redis实战操作功能

    Spring Boot集成Redis实战操作功能

    这篇文章主要介绍了Spring Boot集成Redis实战操作,包括如何集成redis以及redis的一些优点,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-11-11
  • Windows下将JAVA jar注册成windows服务的方法

    Windows下将JAVA jar注册成windows服务的方法

    这篇文章主要介绍了Windows下将JAVA jar注册成windows服务的方法,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-07-07
  • 利用SpringBoot与WebSocket实现实时双向通信功能

    利用SpringBoot与WebSocket实现实时双向通信功能

    随着互联网技术的飞速发展,实时通信技术已经逐渐成为现代Web应用的核心需求,论是在即时消息系统还是物联网(IoT)应用中,WebSocket都提供了一种高效、持久的双向通信方式,本文将深入解析如何利用Spring Boot实现WebSocket通信,需要的朋友可以参考下
    2025-07-07
  • 从基础到实战详解SpringBoot3实现分页操作的完整指南

    从基础到实战详解SpringBoot3实现分页操作的完整指南

    在当今的互联网软件开发领域,处理海量数据是一个绕不开的话题,这篇文章jiang深入探讨在 Spring Boot3 中如何巧妙实现分页操作,下面我们就来详细介绍一下吧
    2025-12-12
  • Java初学者必会的Map集合及其原理

    Java初学者必会的Map集合及其原理

    这篇文章主要给大家介绍Map集合及其原理,该集合中的信息是key-value形式,Map集合与Collection集合又有什么不同呢,要想搞清楚以上问题,下面跟着小编一起来看看吧
    2023-06-06
  • Java实现简单台球游戏

    Java实现简单台球游戏

    这篇文章主要为大家详细介绍了Java实现简单台球游戏,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-07-07

最新评论