关于JDK8升级17及springboot 2.x升级3.x详细指南_Java

jdk 8 升级 17

简介

从 jdk 8 升级到 jdk 17 的过程中，有几个主要的变化，特别是 java platform module system (jpms) 的引入，以及一些包路径的调整。以下是与 jdk 17 相关的一些重要变化：

java platform module system (jpms)
- 模块化：jdk 9 引入了模块系统，将标准 java 库划分为多个模块。这影响了 jdk 17 中的包结构和类的组织方式。
- 模块路径：jdk 11 引入了 --module-path 和 --add-modules 选项，允许用户指定模块路径和加载特定模块。
java ee apis 移除
- jax-rs：javax.ws.rs.* 包现在不在标准 java se 平台上。
- jax-ws：javax.xml.ws.* 包现在不在标准 java se 平台上。
- jax-b：javax.xml.bind.* 包现在不在标准 java se 平台上。
其他变化
- javafx：javafx 已经从标准 java se 平台中移除，现在作为一个独立的模块存在。
  
  如果应用使用了 javafx，确保已经添加了 javafx 模块到应用中
- jsr 355：jsr 355 定义了一些与 javafx 相关的包，这些包也不再包含在标准 java se 平台上。
jdk 17 中的新特性
- jep 391: foreign function & memory api (incubator)：提供了与外部代码和内存交互的能力。
- jep 403: sealed classes：允许类声明为密封，以限制继承。
- jep 404: pattern matching for switch (preview)：引入了模式匹配支持到 switch 语句中。
- jep 414: vector api (fourth incubator)：提供了一种利用向量硬件指令的途径。

javax.* 包移到 jakarta.*

jakarta ee 技术栈：随着 java ee 转变为 jakarta ee，许多 javax.* 包已经被迁移到 jakarta.*包下。这对于使用 java persistence api (jpa)、jsf、ejb 等技术的应用尤为重要。
- javax.persistence.* -> jakarta.persistence.*
- javax.faces.* -> jakarta.faces.*
- javax.ejb.* -> jakarta.ejb.*
- javax.servlet.* -> jakarta.servlet.*
- javax.servlet.jsp.* -> jakarta.servlet.jsp.*
- javax.websocket.* -> jakarta.websocket.*
- javax.naming.* -> jakarta.naming.*
- javax.sql.* -> jakarta.sql.*
- javax.transaction.* -> jakarta.transaction.*
jdk 8 升级到 jdk 17 需确保代码中引用了正确的包名。应该使用 jakarta.* 而不是 javax.*。

maven pom 中更新 java 版本

建议在父项目添加全局变量 java.version，然后在 maven-compiler-plugin 引用

<properties>
    <java.version>17</java.version>
    <project.build.sourceencoding>utf-8</project.build.sourceencoding>
    <project.reporting.outputencoding>utf-8</project.reporting.outputencoding>
</properties>

<build>
    <plugins>
        <plugin>
            <groupid>org.apache.maven.plugins</groupid>
            <artifactid>maven-compiler-plugin</artifactid>
            <version>3.10.1</version>
            <configuration>
                <source>${java.version}</source>
                <target>${java.version}</target>
                <encoding>utf-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

springboot 2.x 升级 3.x

spring-boot 与 cloud、alibaba-cloud 的版本对应

spring-cloud 与 spring-boot 的版本对应详见 spring-cloud 官方文档
spring-alibaba-cloud 与 spring-cloud、spring-boot 的版本对应详见 spring-alibaba-cloud 官方文档

redis 默认配置调整

在 springboot 2.x 的版本中，redis 的默认配置是 spring.redis.*，升级成 springboot 3.x 以后，redis 的默认配置调整为了spring.data.redis.*。

若继续使用 springboot2.x 的 redis 配置，会导致获取不到 redis 的配置。

springboot 3.x 整合 querydsl

主要问题：springboot 升级 3.0，jpa 包路径从 javax 改成 jakarta，在默认情况下，无法生存 q 类，也没办法使用jpaquery

解决方法：

引入依赖。重点：classifier 标签

<dependency>
    <groupid>com.querydsl</groupid>
    <artifactid>querydsl-jpa</artifactid>
    <classifier>jakarta</classifier>
    <version>5.0.0</version>
</dependency>

<dependency>
    <groupid>com.querydsl</groupid>
    <artifactid>querydsl-apt</artifactid>
    <version>5.0.0</version>
    <scope>provided</scope>
    <optional>true</optional>
    <classifier>jakarta</classifier>
</dependency>

引入 maven plugin

 <plugin>
    <groupid>com.mysema.maven</groupid>
    <artifactid>apt-maven-plugin</artifactid>
    <version>1.1.3</version>
    <executions>
        <execution>
		<!--<goals>-->
		<!--	<goal>process</goal>-->
		<!--</goals>-->
            <configuration>
                <outputdirectory>target/generated-sources</outputdirectory>
                <processor>com.querydsl.apt.jpa.jpaannotationprocessor</processor>
            </configuration>
        </execution>
    </executions>
</plugin>

注意：每个项目配置可能会有差别，在编译时可能会报错：attempt to recreate a file for type xxx，导致此错误的情况也不太一致。可能的原因之一是因为配置了 goals，所以此处注释掉 goals，其他情况不一定能适用此方式。

其他注意事项

依赖循环引用报错

如果升级前的 spring boot 版本早于 2.6.0，且存在 spring ioc 对象的循环引用，则需要添加允许循环引用的配置，否则报错
```
spring:
  main:
    allow-circular-references: true
```
webmvcconfigureradapter.class 找不到报错

spring boot 3 基于 spring framework 6，而在 spring framework 5.3 中，webmvcconfigureradapter 类已经被弃用，并在后续版本中移除。

解决方案

使用 webmvcconfigurer 接口：

webmvcconfigureradapter 是一个抽象适配器类，用于实现 webmvcconfigurer 接口。

在 spring framework 6 中，可以直接实现 webmvcconfigurer 接口来定制 web mvc 的行为。

创建自定义配置类：

创建一个新的类，实现 webmvcconfigurer 接口，并重写需要的方法。
```
@configuration
public class webconfig implements webmvcconfigurer {
    @override
    public void addresourcehandlers(resourcehandlerregistry registry) {
        // 自定义资源处理
    }
    @override
    public void configurepathmatch(pathmatchconfigurer configurer) {
        // 自定义路径匹配
    }
    // 其他需要的方法
}
```

spring boot 3.x 支持优雅退出，添加以下配置开启

# 打开优雅退出
server:
  shutdown: graceful
# 多长时间后强制杀掉进程
spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s

maven 及 maven 插件的版本升级

maven 版本升级

为了确保 maven 版本与 java 17 兼容，应该使用一个较新的 maven 版本。java 17 是一个长期支持 (lts) 版本，它是在 2021 年 9 月发布的。因此，应该使用 maven 3.6.0 或更高版本来确保良好的兼容性。

以下是几个推荐的 maven 版本及其发布日期：

maven 3.6.0 - 发布于 2019 年 2 月 10 日
maven 3.6.3 - 发布于 2020 年 3 月 10 日
maven 3.8.1 - 发布于 2021 年 2 月 18 日
maven 3.8.5 - 发布于 2022 年 5 月 23 日

maven 3.8.5 是一个较为推荐的版本，因为它包含了对 java 17 的良好支持以及一些重要的安全修复和改进。

升级 maven 版本

查看当前 maven 版本:

打开终端或命令提示符，运行以下命令来查看已安装的 maven 版本：
```
mvn --version
```
如果还没有安装 maven，或者安装的版本较旧，可以按照下面的步骤安装或升级。
安装或升级 maven:
- windows 用户:
  
  访问 apache maven 官方下载页面下载最新的 maven 版本。
  
  解压下载的文件到一个目录，例如 c:\apache-maven-3.8.5。
  
  将 maven 的 bin 目录添加到系统环境变量 path 中。
  
  设置 m2_home 环境变量，值为 maven 的安装目录。
- linux/macos 用户:
  
  使用包管理器安装 maven，例如对于 ubuntu/debian 使用 apt-get，对于 macos 使用 brew：
```
sudo apt update && sudo apt install maven
```
  或者使用 homebrew：
```
brew install maven
```
  或者从 apache maven 官网下载二进制分发包，解压缩到 /usr/local 或其他位置，并通过 mvn --version 确认安装成功。
设置 java 17 作为默认 jdk:
- windows 用户:
  确保安装了 java 17，并将其路径添加到环境变量 java_home 中。
  
  设置 java_home 环境变量指向 java 17 的安装目录。
- linux/macos 用户:
  安装 java 17，例如使用 sdkman 或者直接从 oracle 或 adoptium 下载。
  
  设置 java_home 环境变量指向 java 17 的安装目录。
  
  确保 java_home 和 path 环境变量被正确设置。
验证 maven 和 java 版本:

再次运行 mvn --version 命令，确保显示的 java 版本为 17，并且 maven 版本为 3.8.5 或更高。
配置 maven 以使用 java 17:

在 pom.xml 文件中指定 java 17 编译和源代码版本，详见 maven-compiler-plugin 版本升级

maven-compiler-plugin 版本升级

为了确保 maven 编译插件 (maven-compiler-plugin) 与 java 17 兼容并支持 spring boot 3 的需求，需要选择一个合适的 maven-compiler-plugin 版本。

截至2023年，maven-compiler-plugin 的最新稳定版本是 3.10.1。该版本与 java 17 兼容，并且适用于 spring boot 3。
下面是 maven-compiler-plugin 的一个示例配置，用于确保使用 java 17 进行编译：
```
<build>
    <plugins>
        <plugin>
            <groupid>org.apache.maven.plugins</groupid>
            <artifactid>maven-compiler-plugin</artifactid>
            <version>3.10.1</version>
            <configuration>
                <source>17</source>
                <target>17</target>
            </configuration>
        </plugin>
    </plugins>
</build>
```
这里的关键配置点包括：
- <source> 和 <target> 都设置为 17，以指示使用 java 17 进行编译。
- <version> 设置为 3.10.1，这是与 java 17 兼容的一个版本。
**请注意，需要根据实际的 maven 和 spring boot 版本进行适当的调整。**如果需要使用特定版本的 maven-compiler-plugin，请查阅官方文档或发布页面以确认版本的兼容性。`