1. 前言

最近一直想把我的開源項目maple-boot升級到j(luò)dk17版本，然后接入Spring AI。拖延癥犯了一直拖拖拖，最近時間空閑較多，開始陸續(xù)著手升級。

整個升級過程 計劃分為3步。

• step1：先將項目升級到j(luò)dk17，使用正常
• step2：生成代碼的模板類升級到Jdk17對應(yīng)的版本
• step3：功能陸續(xù)驗證

本文主要記錄step1將項目升級過程中牽扯到依賴變動升級，當(dāng)然項目用到的依賴并不算多，項目之外的這里不做記錄。

2. 準(zhǔn)備環(huán)境

原項目版本：Jdk8 + springboot 2.7.12

升級后版本：Jdk17 + springboot 3.3.9

這里新建一個maple-boot-17的項目，然后將maple-boot下[base-manage]分支的代碼原封不動的復(fù)制進(jìn)來。

接下來開始修改。

3. 版本升級

3.1 基礎(chǔ)依賴升級

1.首先把項目環(huán)境切換到Jdk17上

2.父級pom文件中spring-boot-starter-parent版本升級到3.3.9

3.項目配置中的java.version由8升級到17

4.maven編譯相關(guān)maven.compiler.source、maven.compiler.target由8升到17

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

這里主要包含：

(1) javax.servlet

(2) javax.annotation

其它javax.net,javax.sql等則繼續(xù)保留著。

6.lombok版本由1.16.18 升級 1.18.30

3.2 相關(guān)組件升級

1.redis相關(guān)

? yml文件配置由spring.redis 變?yōu)?code>spring.data.redis，多了一級data

2.mybatis plus相關(guān)

• mybatis plus版本升級，由3.5.2升級到3.5.9，pom依賴artifactId由mybatis-plus-boot-starter變?yōu)?code>mybatis-plus-spring-boot3-starter
• 分頁插件剝離，新增分頁依賴com.baomidou:mybatis-plus-jsqlparser
• 多數(shù)據(jù)源依賴升級，由3.5.2升級為4.0.0，pom依賴artifactId由dynamic-datasource-spring-boot-starter變?yōu)?code>dynamic-datasource-spring-boot3-starter
• TODO：生成工具暫未調(diào)整，不確定是否有變化

3.對象轉(zhuǎn)化工具dozer版本升級，由6.2.0升級至7.0.0

4.httpclient版本升級，升級至4.5.14

5.接口文檔knife4j升級

由com.github.xiaoymin:knife4j-spring-boot-starter:2.0.7變更為com.github.xiaoymin:knife4j-openapi3-jakarta-spring-boot-starter:4.0.0，Knife4jConfiguration配置類變更

package com.maple.rest.config;

import io.swagger.v3.oas.annotations.OpenAPIDefinition;
import io.swagger.v3.oas.annotations.info.Info;
import io.swagger.v3.oas.annotations.servers.Server;
import org.springframework.context.annotation.Configuration;

/**
 * @author 笑小楓-https://www.xiaoxiaofeng.com
 * @date 2022/6/28
 */
@Configuration
@OpenAPIDefinition(
        info = @Info(title = "笑小楓管理平臺接口",
                description = "管理平臺 API 文檔",
                version = "1.0"),
        servers = @Server(url = "https://www.xiaoxiaofeng.site/api/")
)
public class Knife4jConfiguration {

}

注解變更

更多的變動可以參考官網(wǎng)，這里暫時沒有做進(jìn)一步深究

4. 功能測試

大體試了下，功能都還健在，后續(xù)整理生成工具時，會陸續(xù)測試功能細(xì)節(jié)。

5. 升級總結(jié)

本次項目版本依賴升級大致如下，可能有一些沒有記錄到。

6. 注意事項

1.JDK版本與Spring Boot版本對應(yīng)

Spring Boot不同版本支持的JDK版本如下：

2.Maven版本與Spring Boot版本對應(yīng)

Maven作為構(gòu)建工具，與Spring Boot的兼容性如下：

3.我用的idea 2021.3款的，不支持過高的maven版本，我這里使用的是maven 3.8.1。條件允許建議可以換更高版本的idea，感覺2024版的使用起來也更絲滑…

7.小結(jié)

升級過程中，程序可能會出現(xiàn)各種各式報錯，牽扯到相關(guān)依賴版本變更需要調(diào)整。

到此這篇關(guān)于Springboot項目由JDK8升級至JDK17詳細(xì)教程的文章就介紹到這了,更多相關(guān)Springboot JDK版本升級內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論