jdk8升级JDK21(Springboot2.7.18升级Springboot3.4.0)

目录

背景：

一、maven升级

二、代码改造

2.1 javax替换为jakarta

2.2 swagger2升级swagger3相关更新

2.2.1 新增SpringDocConfig配置类

2.2.2 全局代码更新

2.2.3 全局代码替换（普通+正则替换）

2.3 Mybatis Plus升级

2.4 logback.xml更新

2.5 application.yml更新

三、其他注意事项

3.1 Jdk相关

3.1.1 启动参数

3.2 Spring相关

3.2.1 尾部斜杠匹配取消

3.2.2 RequestParam等传参报错

3.3.3 循环依赖启动报错

---

背景：

由于各种漏洞原因需要升级Spring6，同时项目上还在使用Jdk8，索性将JDK升级为21，同时springboot也升级为最新发布的Springboot3.4.0，在此记录。

一、maven升级

其中关键依赖升级：

• Springboot 3.4.0（2024/11/22发布的稳定版，内部依赖spring 6.2.0、tomcat 10.1.33、logback 1.5.12...）
• Mybatis-plus 3.5.9（Mybatis3.5.16）
• Shiro 2.0.2
• Lombok 1.18.36(注意最低兼容版本 jdk17 >= 1.18.22，jdk21 >= 1.18.30)
• swagger3(springdoc 2.6.0，注意swagger2升级swagger3不再使用io.springfox，需要使用org.springdoc包)
• mysql-connector-j 8.4.0

部分升级注意事项也写在了注释里

<!-- 2024/11/22发布的稳定版，内部依赖spring 6.2.0、tomcat 10.1.33、logback 1.5.12... -->
<dependency>
	<!-- Import dependency management from Spring Boot -->
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-dependencies</artifactId>
	<version>3.4.0</version>
</dependency>

<dependency>
	<groupId>jakarta.servlet</groupId>
	<artifactId>jakarta.servlet-api</artifactId>
	<scope>compile</scope>
</dependency>

<!-- Mybatis Plus全家桶升级，参考https://baomidou.com/getting-started/install/ -->
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-bom</artifactId>
	<version>3.5.9</version>
</dependency>
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-bom</artifactId>
	<version>${mybatis-plus-bom.version}</version>
</dependency>
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-generator</artifactId>
	<version>3.5.9</version>
	<exclusions>
		<exclusion>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
		</exclusion>
	</exclusions>
</dependency>
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-spring-boot3-starter</artifactId>
</dependency>
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-jsqlparser</artifactId>
</dependency>
<dependency>
	<groupId>com.baomidou</groupId>
	<artifactId>mybatis-plus-generator</artifactId>
</dependency>

<!-- 8.0.30之后的版本，mysql依赖的坐标变更 
可参考https://blogs.oracle.com/mysql/post/mysql-connectorj-has-new-maven-coordinates-->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.31</version>
</dependency>

<!-- lombok最低兼容版本 jdk17 >= 1.18.22，jdk21 >= 1.18.30 -->
<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.36</version>
</dependency>

<!-- swagger2升级swagger3不再使用io.springfox，需要使用springdoc-->
<dependency>
	<groupId>org.springdoc</groupId>
	<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
	<version>2.6.0</version>
</dependency>
<dependency>
	<groupId>org.springdoc</groupId>
	<artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
	<version>2.6.0</version>
</dependency>

其他中间件升级（适配SpringBoot3.4.0版本）

<!-- RocketMQ springboot版，文档地址：https://github.com/apache/rocketmq-spring-->
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <version>2.3.1</version>
</dependency>

<!-- Redisson 文档地址：https://redisson.org/docs/integration-with-spring/#spring-boot-starter-->
<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.38.1</version>
</dependency>

<!-- Kafka 此版本springboot默认依赖3.3.0版本spring-kafka-->
<dependency>
    <groupId>org.springframework.kafka</groupId>
    <artifactId>spring-kafka</artifactId>
</dependency>

<!-- ElasticSearch 此版本springboot支持目前最新版es（8.11.1）-->
<dependency>
    <groupId>co.elastic.clients</groupId>
    <artifactId>elasticsearch-java</artifactId>
    <version>8.11.1</version>
</dependency>

<!-- Mapstruct 此版本springboot支持目前最新版es（8.11.1）
    使用时需注意：升级到最新版本后，若想转换List<Entity>，则@Mapper修饰的convert转换类中必须带有Entity单独转换方法，
否则无法直接转换List<Entity>会报错（list转换时会使用单独转换的方法遍历转换）。-->
<dependency>