我把springboot项目从Java 8 升级到了Java 17 的过程总结，愿为君提前踩坑！

清疚 2024-04-27 15:47 4阅读 0赞

> 项目从jdk8升级到jdk17，我不是为了追求java 17的新特性（准确来说也还没有去了解有什么新特性），也不是为了准确与时俱进，永远走在java行列的最前端，纯粹因为项目需要，因为我们都知道，**只要项目能跑，你就不要动它！**

#### 目录 ####

*  背景
 *  目标
 *  环境安装
 *   *  Java 17
     *   *  下载
         *   *  方式一
             *  方式二
         *  配置环境变量与java8共存
     *  SpringBoot3.0.0
     *  Maven 3.6.3+
     *  Idea 2022.2.1+
     *   *  下载
         *  安装
 *  配置IDEA和项目 java17环境
 *   *  IDEA中Maven设置
     *  IDEA环境配置
     *   *  Setting设置
         *  Project Structure设置
 *  问题处理
 *   *  运行项目出现 无效的源发行版: 17
     *  hibernate unknown
     *  ERROR StatusLogger Unable to create Lookup for ctx
     *  java.lang.TypeNotPresentException: Type javax.servlet.http.HttpServletRequest not present
     *  swagger替换为openapi后，会有报错
     *  flyway问题
     *  动态数据源问题
 *  最后

## 背景 ##

> Java 程序员应该都熟悉下面这句话： **版本任他发，我用 Java 8** 。自从 2014 年 3 月 Java SE 8.0(1.8.0)发布，到现在已经是第九年，21 年 9 月 Java SE 17(LTS)也已经发布，但绝大部分 Java 开发人员依然使用 1.8 版本。懒惰是其中的一方面原因，生产环境稳定大于一切的压力之下，既然 Java8 已经表现很好没有什么问题，那么也就没有必要冒险去做版本升级了，毕竟“升级”在很多情况下都意味着工作量和风险。

不过在今年之后，这个情况发生了变化。由于厂商纷纷宣布即将停止 1.8 版本的更新维护：Oracle 于 2019 年 1 月停止商用用途中的更新，2020 年 12 月停止非商用版本更新；AdoptOpenJDK 于 2023 年 9 月或之前停止更新；Amazon Corretto 于 2023 年 6 月或之前停止更新。意味着 23 年 9 月之后，将不再有厂商继续更新 Java 8。

2014年发布的java SE 8和2017年发布的java EE 8，至今还是使用最广泛的java版本，大部分java开发者对于java 8之后的升级总是敬而远之，这跟java 9以后的破坏性升级和oracle的商用协议有关，但随着9月java 17的发布，我们有更多理由去升级和在新项目中使用更新的java了。

--------------------

## 目标 ##

本次操作是mac版本下的

*  Java 8 应用升级到 Java 17
 *  SpringBoot 版本升级到 SpringBoot3.0.0
 *  推荐的 Java 17 开发环境包括：Maven 3.6.3+、Idea 2022.2.1+

--------------------

## 环境安装 ##

### Java 17 ###

#### 下载 ####

##### 方式一 #####

下载链接🔗：[JDK开发工具包17.0.9下载][JDK_17.0.9]

![在这里插入图片描述][14418d13959d4e668ae63108fc012685.png]  
要选择对应的版本去下载，比如我mac，在左上角的苹果标志，直接点击，弹出菜单，点击“关于本机”，确认一下本机电脑的CPU是Intel还是ARM。

1.  如果是Intel，点击“x64 DMG Installer”的右边网址
2.  或者选择 macOS 下的 ARM64 DMG（适用于苹果芯片，如 M1、M2 等）

![在这里插入图片描述][58565cedca56480c928eb6628e39107b.png]  
我的是M2，所以如上图

按照步骤直接默认选项安装即可。

##### 方式二 #####

在 mac 下，也可以使用 sdkman 来安装 jdk 和 maven：  
（其实我一开始是使用的此方法，但是由于那会网络一直不稳定，最后还是使用的方法一）

命令行执行下面操作即可（sdk 相关命令可以使用 sdk help 查看）

curl -s "https://get.sdkman.io" | bash
    
    sdk install java 22.3.r17-grl
    sdk install maven 3.8.2

下载中截图  
![在这里插入图片描述][a5ddd342c36b46a09ea63e01a4c83252.png]

由于我网络不稳定，出现如下报错：

Installing script cli archive...
    * Downloading...
    curl: (28) Failed to connect to github.com port 443 after 75015 ms: Couldn't connect to server
    
    'curl --fail --location --progress-bar "${SDKMAN_SERVICE}/broker/download/sdkman/install/${SDKMAN_VERSION}/${SDKMAN_PLATFORM}" > "$sdkman_zip_file"': command failed with exit code 28.

然后我就再次执行命令

curl -s "https://get.sdkman.io" | bash

结果提示已经存在，可以强制更新  
![在这里插入图片描述][7b9d5df89e3d4178b8013b7c37576e59.png]

算了，我还是卸载重新安装吧：

rm -rf "$HOME/.sdkman"

再次执行上面的安装命令  
继续有报错出来

touch: /Users/myName/.bash_profile: Permission denied
    'touch "$sdkman_bash_profile"': command failed with exit code 1.

可以看到上面报错是要修改`.bash_profile`文件，我们可以自己修改

vim ~/.bash_profile

在`.bash_profile`文件最后一行加上下面内容

export SDKMAN_CANDIDATES_API=https://api.sdkman.io/2
    [[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"

然后执行

source ~/.bash_profile

下载jdk17

sdk install java 22.3.r17-grl

下载中  
![在这里插入图片描述][89a938bdb4024065a5fcebe22faa6579.png]  
我到这里又出现了下载超时的问题了，心里一万只🦙🦙🦙跑过啊，于是我果断去用了方式一

--------------------

#### 配置环境变量与java8共存 ####

由于之前也是一直使用java8，所以下载安装完java17后，可以看下java版本是否有变  
![在这里插入图片描述][75f3941da40248448e231c8a28afa3e1.png]

还是java8，因为我们的环境还是没有变，我的是`.bash_profile`文件  
![在这里插入图片描述][890e458d7d814387aa46000f9dac5340.png]

先看看下载的jdk17在不在默认下载的目录`/Library/Java/JavaVirtualMachines`

![在这里插入图片描述][7f22087ec04d49e4b525cfd465b70a07.png]  
接下来就是更换环境变量，使用jdk17了，如下

vim ~/.bash_profile

增加如下内容

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
    #export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home
    export PATH=$JAVA_HOME/bin:$PATH:.
    export CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.

![在这里插入图片描述][287b5030acdb42fbab0174df1ebc8977.png]  
然后执行保存，再查看版本

source ~/.bash_profile
    java -version

可以发现已经是java17了  
![在这里插入图片描述][a8390743aff74effb0d7fdb2fbc26803.png]

不同Java版本间的切换  
若要将Java17切换到Java其他版本，只需要将`.bash_profile`文件中的JAVA\_HOME改成Java其他版本的目录即可，修改的过程和之前配置JAVA\_HOME环境变量类似。

--------------------

### SpringBoot3.0.0 ###

查看springBoot版本

<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.5.5</version>
    		<relativePath/> 
    	</parent>

这里只要更换版本即可

然后reload maven，一定会有报错，这个我在下面也会有提到

--------------------

### Maven 3.6.3+ ###

这里需要注意下载的版本是否是你的IDEA版本支持的Maven版本  
[Maven官网][Maven]  
![在这里插入图片描述][c3a38107962e4f4fa24e7492545a5519.png]  
点击 Download 拉到最底下，下载历史版本  
![在这里插入图片描述][b76171f3e7a84166a44bb3603a712c0d.png]  
下载解压更新系统变量就不说了

--------------------

### Idea 2022.2.1+ ###

#### 下载 ####

因为社区版免费使用，所以下载社区版安装就好。下载的版本是Idea 2022.2.1+就可以，不做过多阐述。

下载地址：[https://www.jetbrains.com/idea/download/\#section=mac][https_www.jetbrains.com_idea_download_section_mac]

#### 安装 ####

mac 下，ideaIC-2023.1.2-aarch64.dmg 直接双击安装，按照说明完成操作即可。接下来就是启动。

## 配置IDEA和项目 java17环境 ##

### IDEA中Maven设置 ###

进入Idea File->settings…->Build,Execution,Deployment->Build Tools->Maven  
![在这里插入图片描述][bfa50f3f22054d45aa1ef6c8009e2900.png]  
还需要配置另两个地方：Runner和Importing内选择Java17  
![在这里插入图片描述][ae57774a747547818d4b1c2ee6e51fd3.png]  
![在这里插入图片描述][0b6c7760020548dfa279845175f4b522.png]

### IDEA环境配置 ###

#### Setting设置 ####

![在这里插入图片描述][492623cf5307430299a05f6cc02375a3.png]

#### Project Structure设置 ####

File - Project Structure…

![在这里插入图片描述][96364f79e51d49d69fe2be68ba4467c3.png]  
![在这里插入图片描述][16fd82714b6b44088d1ccc806f53bfc2.png]  
![在这里插入图片描述][48849fc587014ea985d2a289f844624b.png]

⚠️如果编译项目出现 java: 无效的源发行版: 17，则需要设置：  
![在这里插入图片描述][3356c77bbb244cc68bccc6a47702c9c0.png]

全部配置完毕，就可以启动项目了，这就会遇到下面一堆的问题了，但是不要慌，我们一个个解决

--------------------

## 问题处理 ##

从这里开始，就是本篇的重点了，一个接一个地处理问题。

### 运行项目出现 无效的源发行版: 17 ###

这个可能性是有两种

1.  环境变量配置后没有成功保存
    
     *  打开shell，执行`java -version`命令，如果出现的是jdk17，则说明环境变量正确，反之再去修改环境变量
2.  idea在更换jdk后没有重启

如果没问题，查看项目目录 External Libraries 外部库中，使用的应该就是Java17，如下  
![在这里插入图片描述][13ac5eda2fc549228e77272319519397.png]

### hibernate unknown ###

maven中Dependencies引入的hibernate报错  
![在这里插入图片描述][8f93eeb5836947dd937d6a27d645f0cd.png]

其实就是版本兼容的问题  
需要删除原来的依赖，然后升级版本：6.1.7.Final

<dependency>
                <groupId>org.hibernate</groupId>
                <artifactId>hibernate-core</artifactId>
                <version>6.1.7.Final</version>
            </dependency>

依赖默认情况下都在如下路径，后面的删除依赖也是同样的  
![在这里插入图片描述][0447dd7a41db4b60ad8e8df8ae6218a7.png]

### ERROR StatusLogger Unable to create Lookup for ctx ###

启动报错  
![在这里插入图片描述][e225636072764ac795c3d1a463acb6f9.png]

ERROR StatusLogger Unable to create Lookup for ctx
     java.lang.NoClassDefFoundError: org/apache/logging/log4j/util/ServiceLoaderUtil
    Caused by: java.lang.ClassNotFoundException: org.apache.logging.log4j.util.ServiceLoaderUtil
    	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    	at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)

这个可以看官方发行版本：[log4j版本：2.22.0][log4j_2.22.0]  
其实也是版本兼容的问题，需要删除原来的依赖，然后升级版本：2.22.0

<dependency>
    				<groupId>org.apache.mvnging.log4j</groupId>
    				<artifactId>log4j-core</artifactId>
    				<version>2.22.0</version>
    			</dependency>
    
    			<dependency>
    				<groupId>org.apache.logging.log4j</groupId>
    				<artifactId>log4j-slf4j-impl</artifactId>
    				<version>2.22.0</version>
    			</dependency>
    
    			<dependency>
    				<groupId>org.apache.logging.log4j</groupId>
    				<artifactId>log4j-jul</artifactId>
    				<version>2.22.0</version>
    			</dependency>
    
    			<dependency>
    				<groupId>org.apache.logging.log4j</groupId>
    				<artifactId>log4j-api</artifactId>
    				<version>2.22.0</version>
    			</dependency>

### java.lang.TypeNotPresentException: Type javax.servlet.http.HttpServletRequest not present ###

启动报错

java.lang.TypeNotPresentException: Type javax.servlet.http.HttpServletRequest not present
    Caused by: java.lang.ClassNotFoundException: javax.servlet.http.HttpServletRequest

这个问题让我找了好半天的解决办法  
参考链接：

1.  [Springfox Type javax.servlet.http.HttpServletRequest not present][]
2.  [Spring Boot3.0(六)：整合swagger][Spring Boot3.0_swagger]
3.  [Type javax.servlet.http.HttpServletRequest not present \#4061][Type javax.servlet.http.HttpServletRequest not present _4061]

原因是：SpringFox 和 Spring Boot 3 的组合将无法工作。这里就需要替换了

解决：  
需要删除原来的依赖

*  删除SpringFox的引用并且对于spring-boot和swagger-ui之间的集成

<dependency>
    				<groupId>io.springfox</groupId>
    				<artifactId>springfox-boot-starter</artifactId>
    				<version>${springfox.version}</version>
    			</dependency>

*  将库添加到项目依赖项列表中（无需额外配置）：

<dependency>
        <groupId>org.springdoc</groupId>
        <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
        <version>2.2.0</version>
    </dependency>

### swagger替换为openapi后，会有报错 ###

这里替换为如下类即可  
![在这里插入图片描述][31eec1cf454e4fb1a5fa47b0238503e5.png]  
![在这里插入图片描述][9b0b5501954b48a5a873a4b9888f09f2.png]  
更多内容可以查看[springfox迁移指南][springfox]

### flyway问题 ###

org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration$FlywayConfiguration and org.flywaydb.core.api.configuration.FluentConfiguration  
![在这里插入图片描述][fbb405d2cbda4f14943e0fcd566be449.png]

***************************APPLICATION FAILED TO START***************************Description:An attempt was made to call a method that does not exist. The attempt was made from the following location:
    
    org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration$FlywayConfiguration.configureProperties(FlywayAutoConfiguration.java:234)The following method did not exist:    'org.flywaydb.core.api.configuration.FluentConfiguration org.flywaydb.core.api.configuration.FluentConfiguration.oracleSqlplus(boolean)'The calling method's class, org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration$FlywayConfiguration, was loaded from the following location:
    
    Action:Correct the classpath of your application so that it contains compatible versions of the classes org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration$FlywayConfiguration and org.flywaydb.core.api.configuration.FluentConfiguration

解决  
升级版本：

<dependency>
    				<groupId>org.flywaydb</groupId>
    				<artifactId>flyway-core</artifactId>
    				<version>7.14.0</version>
    			</dependency>

并且：将属性设置为spring.flyway.enabled来禁用 Flyway 的自动配置

参考链接🔗：[Spring-boot 3.0不支持flyway 7.15][Spring-boot 3.0_flyway 7.15]

### 动态数据源问题 ###

***************************
    APPLICATION FAILED TO START
    ***************************
    
    Description:
    
    Parameter 0 of constructor in com.axiomesh.bt.common.BTInitializer required a bean of type 'com.baomidou.dynamic.datasource.creator.DefaultDataSourceCreator' that could not be found.
    
    
    Action:
    
    Consider defining a bean of type 'com.baomidou.dynamic.datasource.creator.DefaultDataSourceCreator' in your configuration.

解决

*  升版本
 *  改配置（dynamic-datasource-spring-boot-starter—》dynamic-datasource-spring-boot3-starter）
 *  删除依赖，重新下载

<dependency>
    	<groupId>com.baomidou</groupId>
    	<artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
    	<version>4.2.0</version>
    </dependency>

![在这里插入图片描述][5a8d21f3c77149928d862bd5525b496c.png]

然后再次启动项目，如果你还有别的问题，那就一一解决，大部分都是版本兼容问题、旧的依赖未清除问题，加油！

--------------------

## 最后 ##

>  *  **好看的灵魂千篇一律，有趣的鲲志一百六七！**
>  *  如果觉得文章还不错的话，可以**点赞+收藏+关注** 支持一下，**[鲲志的主页][Link 1]** 还有很多有趣的文章，欢迎小伙伴们前去点评
>  *  如果有什么需要改进的地方还请大佬指出❌

![在这里插入图片描述][1282d0d8cd384b1cb81550f0bcdd7254.gif_pic_center]

[JDK_17.0.9]: https://www.oracle.com/java/technologies/downloads/#jdk17-mac
[14418d13959d4e668ae63108fc012685.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/5ffc9456978e42cca9ecfcfdefd04260.png
[58565cedca56480c928eb6628e39107b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/2d077f7a6d2e4cbbbb04d87c454aa7f3.png
[a5ddd342c36b46a09ea63e01a4c83252.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/6109b40ffea1413ca7bab449434eabb5.png
[7b9d5df89e3d4178b8013b7c37576e59.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/18f6e6bddf534707ba635c731b6c731a.png
[89a938bdb4024065a5fcebe22faa6579.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/7138827933e645858955ad32ca0af2ea.png
[75f3941da40248448e231c8a28afa3e1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/5754d3e730844c9cb27b0bbae34ceaf2.png
[890e458d7d814387aa46000f9dac5340.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/51486ec3704145a090cc9464b3161d10.png
[7f22087ec04d49e4b525cfd465b70a07.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/7598e39dd02048e4ab5e86d095bf3ed7.png
[287b5030acdb42fbab0174df1ebc8977.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/7fa335df086d471cbc87c906b2c2e03e.png
[a8390743aff74effb0d7fdb2fbc26803.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/c6dffb2fcd654a89965eade53838003a.png
[Maven]: https://maven.apache.org/download.cgi
[c3a38107962e4f4fa24e7492545a5519.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/ff9f76ae1d4e42e78dbbcba31646b177.png
[b76171f3e7a84166a44bb3603a712c0d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/62302cd0b4a34fc1ac4487027f5b96a6.png
[https_www.jetbrains.com_idea_download_section_mac]: https://www.jetbrains.com/idea/download/#section=mac
[bfa50f3f22054d45aa1ef6c8009e2900.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/a9ca232e688c48b59edd2d8f049ee04f.png
[ae57774a747547818d4b1c2ee6e51fd3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/49ae90789aa24201bd8c82b9dcfeb09b.png
[0b6c7760020548dfa279845175f4b522.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/fbeced195de94d76b3259ff22ac1dce2.png
[492623cf5307430299a05f6cc02375a3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/4012b273eea74ae794865292b669134e.png
[96364f79e51d49d69fe2be68ba4467c3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/924fd367cae64792a392b26b2918b778.png
[16fd82714b6b44088d1ccc806f53bfc2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/6db22a6502ea400c8f0e921d22f38bfb.png
[48849fc587014ea985d2a289f844624b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/9806e50a9da1494b94e4e89a9941ba63.png
[3356c77bbb244cc68bccc6a47702c9c0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/df86ab8d8a6e48c68269323c535ca717.png
[13ac5eda2fc549228e77272319519397.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/2335ca0fd722400b805a0b7aa63d321e.png
[8f93eeb5836947dd937d6a27d645f0cd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/93139a4b730249a3bb54b361858474c7.png
[0447dd7a41db4b60ad8e8df8ae6218a7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/43de949738724e57a75b5bfb4990442c.png
[e225636072764ac795c3d1a463acb6f9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/b1fe2c8b818c41bf8f49484e3ec7bec9.png
[log4j_2.22.0]: https://logging.apache.org/log4j/2.x/release-notes.html
[Springfox Type javax.servlet.http.HttpServletRequest not present]: https://stackoverflow.com/questions/71549614/springfox-type-javax-servlet-http-httpservletrequest-not-present
[Spring Boot3.0_swagger]: https://zhuanlan.zhihu.com/p/637601405
[Type javax.servlet.http.HttpServletRequest not present _4061]: https://github.com/springfox/springfox/issues/4061
[31eec1cf454e4fb1a5fa47b0238503e5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/0633a75308db405a8488939ddc5cb817.png
[9b0b5501954b48a5a873a4b9888f09f2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/c78f085eddf345d690e8f2234a7b7b5c.png
[springfox]: https://springdoc.org/#migrating-from-springfox
[fbb405d2cbda4f14943e0fcd566be449.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/8293e6f73d6a4e649873a4cbc5fadc37.png
[Spring-boot 3.0_flyway 7.15]: https://github.com/spring-projects/spring-boot/issues/33391
[5a8d21f3c77149928d862bd5525b496c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/4afd752a80bf4187bd9ea15820e0b9c3.png
[Link 1]: https://kunzhi.blog.csdn.net/
[1282d0d8cd384b1cb81550f0bcdd7254.gif_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/27/dd9b4d91047e43e19a80949878545e2c.gif