一、概述

鉴于JDK8已经是老古董，还有性能问题，兼且各个公司已经不再维护1.8的JDK，所以升级公司的核心产品之一的后端到JDK到17是相对要紧的事情.

通过升级到jdk17，具有以下好处:

• 不要在头疼同时适应两个jdk，放下适应JDK8的负担
• 在生产环境基本上只需要部署一个jdk即可
• 具有更好的性能
• 能够利用上更好更新的组件版本。例如springboot3,spring6.x都是基于jdk17的。
• 更好的安全性。这对于项目很重要。因为许多客户会安排安全测试，过时的jdk是一个不好解决的问题。升级到jdk17能够更好解决这个问题
• 更好的竞争能力。当我们的核心jdk是17的时候，毫无疑问比那些还沉滞在jdk8的竞争对手更好，尤其是功能相差不大的情况下。

本次升级后端，大概耗费了一周的时间，其次httpsecurity耗费了比较多的时间.

整体上，还算顺利.

  。

二、步骤详情

  。

总体上遵循以下步骤:

(1) 升级准备 。

(2) 确定spring组件版本 。

到spring.io上看了下，选择springboot-3.3.0 。

(3) 确定其它组件版本 。

(4) 升级有关代码 。

(5) 调整其它配置 。

(6) 解决有关异常 。

(7) 测试 。

(8) 完成升级 。

2.1. 升级准备

由于这是一个大的版本升级，所以需要做以下准备:

(1) 确认是否能升级 。

除了前文提到的原因，还需要确定当前这个产品是否可以升级，毕竟JDK17和JDK1.8不一样，且升级了JDK17后，有关的组件都要一起升级（是否有相关的版本，相关版本是否稳定?) 。

考虑到我们的产品没有使用太多的三方软件，即使有，也都是流行的 。

现在jdk17都已经发布了快3年了；有很多其它公司也升级到了jdk17;部分公司已经把他们的产品升级到JDK21了.

结合这些因素，产品升级到jdk17不存在技术障碍！ 。

之所以没有考虑立刻升级到JDK21，是因为其它很多产品都在JDK17，其次一次性到21，没有那么大把握。步子太大，会不会扯蛋了?

虽然官方的文档说springboot3.3.x支持JDK22。但是由于三方组件的存在，导致不敢一次性迈出太大的步子.

(2) 在git/svn上开一个分支，或者直接开一个新的仓库,不要影响现有的主干代码 。

2.2. spring组件版本

在spring.io上可以看到可用的版本，本着使用最新可用版本的原则，选择了

• springboot-3.3.1 (ga)
• spring-6.1.10 这是springboot限定的版本，所以只需要选择springboot版本即可

按照spring惯例，当升级的时候，通常相关的组件都是一期升级的，所以总的来说，只要指定springboot版本即可.

  。

2.3.确定其它组件版本

  。

分类 。	组件 。	功能描述 。	旧版本 。	升级 。	新版本 。	说明 。
数据存取 。	druid-spring-boot-starter 。	数据连接和连接池管理 。	1.2.11 。	是 。	1.2.23 。	核心组件，必须升级 。
jdbc驱动 。	* 。	jdbc连接 。	。	否 。	。	主要看各个厂家，考虑到jdbc驱动都是比较成熟的，在jdk17中运行，问题应该也不大 。
消息队列 。	org.apache.rocketmq/rocketmq-client 。	amqp 。	5.1.0 。	否 。	。	暂时不升级，这个需要较长时间的测试 。
http请求 。	httpclient,httpcore 。	rest请求 。	4.5.13 。	是 。	5.3.1/5.2.4 。	原来是: org.apache.httpcomponents/httpclient 。 现在是: org.apache.httpcomponents.client5/httpclient5 。
http 。	javax.servlet/javax.servlet-api 。	servlet 。	4.0.1 。	否 。	。	移除 。
http 。	jakarta.servlet/jakarta.servlet-api 。	servlet 。	6.0.0 。	否 。	。	新增。用于替代javax.servlet-api 。
JSON 。	fastjson2 。	JSON 。	2.0.32 。	是 。	2.0.51 。	fastjson2bug较多，尽可能升级下 。
JSON 。	com.jayway.jsonpath/json-path 。	JSON路径分析 。	2.8.0 。	否 。	。	。
ORM 。	mybatis-spring-boot-starter 。	orm 。	2.2.2 。	是 。	3.0.3 。	不升级会导致mybatis有关bean初始化异常 。
ORM 。	pagehelper-spring-boot-starter 。	分页 。	1.4.3 。	是 。	2.1.0 。	被mybatis依赖 。
ORM 。	jsqlparser 。	sql解析 。	4.2 。	是 。	4.7 。	被pageHelper依赖 。
XML 。	javax.xml.bind/jaxb-api 。	XML解析 。	2.3.1 。	否 。	。	暂时不可替代，不可删除，也不需要升级 。
文档 。	swagger 。	文档 。	。	否 。	。	从现有版本移除 。
定时/调度 。	quartz 。	定时/调度 。	2.3.2 。	否 。	。	。
通用工具 。	org.apache.commons/common-lang3 。	。	3.12.0 。	是 。	3.14.0 。	。
通用工具 。	org.apache.commons/commons-pool2 。	。	2.9.0 。	是 。	2.12.0 。	。
通用工具 。	commons-io/commons-io 。	。	2.11.0 。	否 。	。	。
通用工具 。	commons-fileupload/commons-fileupload 。	。	1.4 。	否 。	。	。
存储 。	minio 。	。	8.2.1 。	否 。	。	。
编译 。	maven-compiler-plugin 。	编译 。	3.1 。	是 。	3.13.0 。	。

注

1. 主要考虑到核心组件即可，其它的小组件遇到了再解决。
2. 有什么版本可用，可以访问https://mvnrepository.com，或则各个组件官网（一般是github),或者是国内镜像网站，例如阿里的https://developer.aliyun.com/mvn/search
3. 部分组件版本必须在升级中调试后才可以确定

2.4. 升级有关代码

当更换了以下组件之后，需要尽快修改代码，修改的原因主要包含:

(1) 配置变更 。

主要是spring升级导致，可能需要修改配置。当然也可能是其它的组件 。

(2) 包路径变更 。

(3) 方法不存在 。

(4) 方法过时 。

这个需要特别注意-如果可能应该尽量把过时的方法移除掉，替换为正常的方法.

2.4.1. 修改yml配置

• 修改范围-spring.redis修改为spring.data.redis--这是spring要扩大spring.data的范围

      在spring.data的域名之下，有很多的内容，远不止redis.除了基本的JDBC,还有Rest,elasticsearch,jpd,ldap等等.

• 添加参数（bean相关)

  。

spring   main     allow-circular-references: true 。     allow-bean-definition-overriding: true 。

  。

在spring6.1.10中，这两个属性默认是false.如果你的项目不存在循环引用，或者覆盖定义的情况，那么可以不添加. 。

• 移除配置

      移除swagger配置-这个太垃圾，过分入侵，还浪费了自有的注释，增大程序员的工作量 。

希望有直接能够利用javaDoc的类似组件.

     。

2.4.2. java基础类型有关的

基础类型主要指Integer,Long,BigDecimal,BigInteger等等.

在jdk17中，许多方法已经被标注为过时(deprecated).

(1) java基类 new Class("xxx")需要修改为 Class.valueOf("xxx") 。

new Long("xx"),new Integer("xxx"),new Byte("xx"),new Short("") 。

这些都要修改为对应的valueOf("xxx").

jdk这么做，主要是出于性能考虑，尤其针对Integer.

(2) Class.newInstance() 。

需要把这个替换为getDeclaredConstructor().newInstance() 。

(3) Spring.Base64Util过时，改用apache的Base64 。

(4) ruoyi自身的Base64,移除掉，避免和apache的冲突.

(5) ruoyi自身的md5Util移除 。

从spring自身的改变来看，spring也逐渐向java标准和阿帕奇基金会靠近，一个是为了标准，其次是避免浪费 。

时间，最后是不要给spring用户带来困扰。spring只要做好自己的就行了.

ruoyi如果用于项目还是可以的，但是用于产品开发还是需要进行较多的改造。 因为产品要求更高的安全、适应度、性能等.

2.4.3. servlet相关

由于在jdk17中移除了javax的部分包，所以很多javax.xxx都需要修改jakarta.xxx 。

这里主要包含:

(1) javax.servlet 。

(2) javax.annotation 。

其它javax.net,javax.sql等则继续保留着.

  。

2.4.4. httpclient相关

具体略，总之需要修改.

httpclient5有重大变更：支持http2,异步支持，更好的连接池等 。

2.4.5. spring-security

这个改变比较大，在spring6.x主要通过注解和定义bean来实现spring-security配置，而在5.x中，则是通过扩展WebSecurityConfigurerAdapter来实现.

  。

@Configuration 。 @EnableWebSecurity 。 @EnableGlobalAuthentication 。 @EnableMethodSecurity(prePostEnabled = true, securedEnabled = true) 。 public class SecurityConfig { 。 } 。   。

  。

注意，不要去override已有的实现，否则配置还是比较麻烦的.

spring的思路就是你可以改配置，改零件，但是不要改核心。如果要改核心，那么太费劲了.

在这个类中实现以下几个bean即可:

• AuthenticationProvider
• AuthenticationManager
• SecurityFilterChain
• BCryptPasswordEncoder

其中SecurityFilterChain是关键，这里主要配置白名单.

另外一个变化是，禁用了默认的logout,而是新增了一个/logout接口:

  。

/** 。 * 执行退出 。 * @param request 。 * @return  。 * @since 1.5 。 */ 。 @PostMapping("/logout") 。 public AjaxResult logout(HttpServletRequest request) { 。 try { 。 LoginUser user=SecurityUtils.getLoginUser(), String key=CacheConstants.LOGIN_TOKEN_KEY + user.getToken(), redisCache.deleteObject(key), return AjaxResult.success(), } 。 catch(Exception e) { 。 //如果有异常，则证明已经退出了，不要阻拦 。 return AjaxResult.success(), } 。 } 。

  。

2.4.6. jsqlparser

主要是因为pageHelper升级了.

当然产品本身也有用到jsqlparser.

2.5. 调整其它配置

主要是编译方面的配置.

由于升级了jdk，包括核心组件maven-compiler-plugin，所以有些原来的默认设置需要进行调整.

2.5.1. 调整编译选项

在eclipse中，其实只需要设置pom.xml中配置即可，无需修改工程的环境配置.

  。

<plugin> 。 <groupId>org.apache.maven.plugins</groupId> 。 <artifactId>maven-compiler-plugin</artifactId> 。 <version>3.13.0</version> 。 <configuration> 。 <source>${java.version}</source> 。 <target>${java.version}</target> 。 <encoding>${project.build.sourceEncoding}</encoding> 。 <parameters>true</parameters> 。 </configuration> 。 </plugin> 。

  。

红色部分添加上去，并设置为true.

如果不添加这个，那么spirng中很多需要通过反射获取信息的方法可能存在问题.

因为这个选项会让java把.java编译为.class的时候，保留方法的名称，而不是把方法名称随意修改为不认识的名称.

  。

2.6. 解决有关异常

  。

2.6.1. bean异常

2.6.1.1. 循环引用和覆盖

如前，主要新版本中，有些参数修改了默认值，所以修改如下:

spring   main     allow-circular-references: true 。     allow-bean-definition-overriding: true 。

  。

2.6.1.2. @Primary问题

当有多个Datasource类型的Bean，或者类似其它的，则必须为Bean添加@Primary的注解，否则回报告异常.

Parameter 0 of method sqlSessionFactory in com.ruoyi.framework.config.db.MyBatisConfig required a single bean, but 3 were found

触发异常的具体代码如下:

  。

  。

  。

而在以前的版本中不存在这个！ 。

解决方式有两个:

(1) 在参数上简单添加@Qualifier("masterDataSource")  -- 解决了mybatis,但是还要解决quartz等等。放弃这个方法 。

(2) 直接修改定义DataSource的地方，为主bean添加@Primary ，就用这个✔ 。

  。

2.6.2. jackson序列化异常

无法处理key类型不是String类型,例如如果是以下类型的JSON 。

  。

{ 。 "batchDetail": { 。    1: "good" 。 } 。 } 。

  。

在序列化的时候会报告异常:

org.springframework.http.converter.HttpMessageNotWritableException: Could not write JSON: class java.lang.Integer cannot be cast to class java.lang.String (java.lang.Integer and java.lang.String are in module java.base of loader 'bootstrap') 。

  。

必须自定义HttpMessgeConverter，以便可以自定义处理这种类型的key.

但这会导致自定义白名单功能错误，所以还需要调整白名单功能 。

  。

2.6.3. factoryBeanObjectType异常

经过定位，这是mybatis没有升级导致的.

注：一开始的时候，并没有立刻要升级mybatis，虽然意识到了，但是并没有那么做.

  。

  。

2.7. 测试

(1) 每个地方都需要测试 。

(2) 反复测试 。

这是总的原则.

测试需要持续较长时间,严格而言，需要再考费一个月左右.

  。

从目前来看，总体是可用！ 。

从性能上看，JDK17的程序的确响应更快一些，从页面的响应也可以看出来！ 。

  。

2.8. 完成升级

    。

    完成升级后，关闭原来git上代码的权限，设置为只读，并通知有关人.

  。

最后此篇关于从JDK8升级到JDK17的文章就讲到这里了,如果你想了解更多关于从JDK8升级到JDK17的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。