JDK 8 升级 17 及 springboot 2.x 升级 3.x 指南

一、JDK 8 升级 17

1.1、简介

从 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)：提供了一种利用向量硬件指令的途径。

1.2、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 版本

<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-cloud 与 spring-boot 的版本对应

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

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 类已经被弃用，并在后续版本中移除。

解决方案

• 1、使用 WebMvcConfigurer 接口
  • WebMvcConfigurerAdapter 是一个抽象适配器类，用于实现 WebMvcConfigurer 接口。
  • 在 Spring Framework 6 中，可以直接实现 WebMvcConfigurer 接口来定制 Web MVC 的行为。
• 2、创建自定义配置类
  • 创建一个新的类，实现 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 插件的版本升级

5.1、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 的良好支持以及一些重要的安全修复和改进。

5.2、升级 Maven 版本

Windows

• 下载需要的版本
• 解压maven到自定义盘符
• 配置环境变量
• 验证是否安装成功

Linux/macOS

• sudo apt update && sudo apt install maven

5.3、设置 Java 17 作为默认 JDK

安装配置jdk17

• 下载安装jdk17安装包
• 解压安装包
• 配置jdk17环境变量

5.4、验证 Maven 和 Java 版本

• java -version
• mvn --version

六、maven-compiler-plugin 版本升级

• 为了确保 Maven 编译插件 (maven-compiler-plugin) 与 Java 17 兼容并支持 Spring Boot 3 的需求，需要选择一个合适的 maven-compiler-plugin 版本。
• 需要根据实际的 Maven 和 Spring Boot 版本进行适当的调整。**如果需要使用特定版本的 maven-compiler-plugin，请查阅官方文档或发布页面以确认版本的兼容性。`

<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>