JDK 8 升级到 17 与 Spring Boot 2.x 升级到 3.x 的详细指南

写在前面
前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到网站

文章目录

JDK 8 升级 17

简介

从 JDK 8 升级到 JDK 17 的过程中，有几个主要的变化，特别是 Java Platform Module System (JPMS) 的引入，以及一些包路径的调整。以下是与 JDK 17 相关的一些重要变化：

javax.* 包移到 jakarta.*

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-boot 与 cloud、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

解决方法：

1. 引入依赖。重点：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>
   

2. 引入 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:
  main:
    allow-circular-references: true

# 打开优雅退出
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.8.5 是一个较为推荐的版本，因为它包含了对 Java 17 的良好支持以及一些重要的安全修复和改进。

升级 Maven 版本

1. 查看当前 Maven 版本:

   打开终端或命令提示符，运行以下命令来查看已安装的 Maven 版本：

   mvn --version
   

   如果还没有安装 Maven，或者安装的版本较旧，可以按照下面的步骤安装或升级。

2. 安装或升级 Maven:

3. Windows 用户:

   1. 访问 Apache Maven 官方下载页面 下载最新的 Maven 版本。
   2. 解压下载的文件到一个目录，例如 C:\apache-maven-3.8.5。
   3. 将 Maven 的 bin 目录添加到系统环境变量 PATH 中。
   4. 设置 M2_HOME 环境变量，值为 Maven 的安装目录。

4. Linux/macOS 用户:

   1. 使用包管理器安装 Maven，例如对于 Ubuntu/Debian 使用 apt-get，对于 macOS 使用 brew：

      sudo apt update && sudo apt install maven
      

      或者使用 Homebrew：

      brew install maven
      

   2. 或者从 Apache Maven 官网下载二进制分发包，解压缩到 /usr/local 或其他位置，并通过 mvn --version 确认安装成功。

5. 设置 Java 17 作为默认 JDK:

6. Windows 用户:
   1. 确保安装了 Java 17，并将其路径添加到环境变量 JAVA_HOME 中。
   2. 设置 JAVA_HOME 环境变量指向 Java 17 的安装目录。
7. Linux/macOS 用户:
   1. 安装 Java 17，例如使用 sdkman 或者直接从 Oracle 或 Adoptium 下载。
   2. 设置 JAVA_HOME 环境变量指向 Java 17 的安装目录。
   3. 确保 JAVA_HOME 和 PATH 环境变量被正确设置。

8. 验证 Maven 和 Java 版本:

   再次运行 mvn --version 命令，确保显示的 Java 版本为 17，并且 Maven 版本为 3.8.5 或更高。

9. 配置 Maven 以使用 Java 17:

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

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>

**请注意，需要根据实际的 Maven 和 Spring Boot 版本进行适当的调整。**如果需要使用特定版本的 maven-compiler-plugin，请查阅官方文档或发布页面以确认版本的兼容性。`

作者：墨鸦_Cormorant