Java 11项目升级到Java 21过程

原创于 2024-08-19 19:19:21 发布 · 1.6k 阅读

CC 4.0 BY-SA版权

文章标签：

参考链接

名称	链接
OpenJDK 21官方下载链接	下载 Microsoft Build of OpenJDK \| Microsoft Learn

一、简介

有一个Java 11项目，应老板的要求需要升级到Java 21，用的是 Spring Boot 2.7.15 以及 MyBatis-Plus 3.5.2 等。

一番折腾后成功升级到 Java 21, 启用了虚拟线程。项目启动时间降低了一半以上, 内存使用降低了将近一半。

二、操作记录

首先，直接暴力升级到 Java 21，相应的 Spring Boot 版本升级到 3.3.2，这个时候项目是启动不了的。

2.1 升级 javax 到 jarkata

由于Springboot 3 使用的是tomcat 10 版本，需要对引入的依赖进行修改

例如修改NotBlank注解的引入

# 修改前
javax.validation.constraints.NotBlank

# 修改后
jarkata.validation.constraints.NotBlank

2.2 解决循环依赖并启用虚拟线程

修改项目配置 application.yaml, 允许循环依赖，并启用虚拟线程，如下

spring:
  main:
    # 允许循环引用
    allow-circular-references: true
  mvc:
    pathmatch:
      # 修复springdoc报错
      matching-strategy: ANT_PATH_MATCHER
  threads:
    # 虚拟线程
    virtual:
      enabled: true

2.3 升级Mybatis版本

在pom文件中修改如下

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.6</version>
        </dependency>

MyBatis-Plus 升级后，所有count的查询原来结果类型由Integer改为Long了，代码里也要做相应的调整。

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.6</version>
        </dependency>

2.4 OpenAPI 文档

OpenAPI文档方面，原来用的是 SpringFox 2.9.2 和 knife4j 2.0.9。SpringFox 已经不怎么维护了，适配Spring Boot 3 比较难，就放弃了，改用 springdoc 2.5.0 和 knife4j 4.5.0，pom.xml 相关修改如下：

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

            <dependency>
                <groupId>com.github.xiaoymin</groupId>
                <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
                <version>4.5.0</version>
            </dependency>

SwaggerConfig.java 相应修改如下：

package com.runjitech.core.config;


import io.swagger.v3.oas.annotations.OpenAPIDefinition;
import io.swagger.v3.oas.annotations.enums.SecuritySchemeType;
import io.swagger.v3.oas.annotations.info.Contact;
import io.swagger.v3.oas.annotations.info.Info;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.security.SecurityScheme;
import io.swagger.v3.oas.annotations.security.SecuritySchemes;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;


@Configuration
@OpenAPIDefinition(info = @Info(title = "REST API", version = "1.0",
        description = "接口文档",
        contact = @Contact(name = "smartworld")),
        security = {@SecurityRequirement(name = "bearerToken")}
)
@SecuritySchemes({
        @SecurityScheme(name = "bearerToken", type = SecuritySchemeType.HTTP,
                scheme = "bearer", bearerFormat = "JWT")
})
public class SwaggerConfig {

    @Bean
    public GroupedOpenApi adminApi() {
        String[] packagesToScan = {
                "com.runjitech.mall.controller.admin",
        };
        return GroupedOpenApi.builder()
                .group("admin")
                .packagesToScan(packagesToScan)
                .build();
    }

    @Bean
    public GroupedOpenApi appApi() {
        String[] packagesToScan = {
                "com.runjitech.mall.controller.app",
        };
        return GroupedOpenApi.builder()
                .group("app")
                .packagesToScan(packagesToScan)
                .build();
    }

    @Bean
    public GroupedOpenApi commonApi() {
        String[] packagesToScan = {
                "com.runjitech.mall.controller.common",
        };
        return GroupedOpenApi.builder()
                .group("common")
                .packagesToScan(packagesToScan)
                .build();
    }

}

2.5 虚拟线程卡顿问题

项目启用虚拟线程遇到的卡顿问题，确定是原来的JDBC驱动版本没有适配虚拟线程导致的，需要升级数据库连接驱动。

      <dependency>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <version>42.7.3</version>
      </dependency>

2.6 升级lombok依赖

我在本地采用的lombok版本是1.18.12，然后运行打包报错如下

class lombok.javac.apt.LombokProcessor (in unnamed module @0x2ee0b92) cannot access class com.sun.tools.javac.processing.JavacProcessingEnvironment (in module jdk.compiler) because module jdk.compiler does not export com.sun.tools.javac.processing to unnamed module @0x2ee0b92

官网上JDK9+推荐我们使用1.18.34版本

pom修改如下

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
            <version>1.18.34</version>
        </dependency>