一、概述
鉴于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 | |
注:
- 主要考虑到核心组件即可，其它的小组件遇到了再解决。
- 有什么版本可用，可以访问https://mvnrepository.com，或则各个组件官网（一般是github),或者是国内镜像网站，例如阿里的https://developer.aliyun.com/mvn/search
- 部分组件版本必须在升级中调试后才可以确定
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}\ \
红色部分添加上去，并设置为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上代码的权限，设置为只读，并通知有关人。