springboot升级到3.x + jdk升级到17

本文介绍了如何将基础组件从Java1.8升级到1.7,SpringBoot从2.7.6升级到3.1.2,以及SpringCloudAlibaba、Maven、jakarta包替换、log4j版本升级、IDEA迁移工具和代码调整等内容,包括处理遗留的编译错误和mybatis版本问题。
部署运行你感兴趣的模型镜像

基础组件版本升级:

jdk由1.8升级到17

spring-boot由2.7.6升级到3.1.2版本

spring-cloud-alibaba由2021.0.4.0升级到2022.0.0.0-RC2版本

maven构建插件里的配置要改为17:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <release>17</release>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

javax相关的包要改为jakarta:

<!-- 废弃 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
</dependency>

<!-- 改为 jakarta.servlet -->
<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
</dependency>

Spring Boot3.0已经将依赖项从Java EE迁移到Jakarta EE API(主要是避免Oracle 的版权问题),所以要将项目中的 javax.servlet.* 改为 jakarta.servlet.* 

IDEA工具提供了迁移工具,可以较为方便的修改Jakarta

IDEA官方文档:Migrate | IntelliJ IDEA Documentation

log4j需要升级到2.19.0及以上版本:

<!-- log4j升级到2.19.0 -->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.19.0</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId> ...... </artifactId>
    <version>2.19.0</version>
</dependency>

代码层面的一些问题:

1、org.springframework.web.filter.HttpPutFormContentFilter已经被废弃并移除了,可以使用org.springframework.web.filter.FormContentFilter来替代。
FormContentFilter类能够解析PUT和PATCH请求中的表单数据并将其作为请求参数传递给控制器方法。

// 如果之前过滤器配置了HttpPutFormContentFilter
@Bean
public FilterRegistrationBean<Filter> HttpPutFormContentFilter() {
    FilterRegistrationBean<Filter> registrationBean = new FilterRegistrationBean<Filter>();
    registrationBean.setFilter(new HttpPutFormContentFilter());
    registrationBean.addUrlPatterns("/*");
    registrationBean.setOrder(2);
    return registrationBean;
}

// 改成FormContentFilter
// FormContentFilter类能够解析PUT和PATCH请求中的表单数据并将其作为请求参数传递给控制器方法
@Bean
public FilterRegistrationBean<Filter> FormContentFilter() {
    FilterRegistrationBean<Filter> registrationBean = new FilterRegistrationBean<Filter>();
    registrationBean.setFilter(new FormContentFilter());
    registrationBean.addUrlPatterns("/*");
    registrationBean.setOrder(2);
    return registrationBean;
}

2、org.springframework.web.servlet.handler.HandlerInterceptorAdapter已经被废弃并移除了,可以使用org.springframework.web.servlet.handler.HandlerInterceptor接口来替代。 

@Component
public class CustomInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        HandlerInterceptor.super.preHandle(request, response, handler);
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        HandlerInterceptor.super.postHandle(request, response, handler, modelAndView);
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        HandlerInterceptor.super.afterCompletion(request, response, handler, ex);
    }
}

3、编译错误:

无法将类 org.springframework.boot.actuate.endpoint.web.servlet.WebMvcEndpointHandlerMapping中的构造器 WebMvcEndpointHandlerMapping应用到给定类型; 

WebMvcEndpointHandlerMapping构造方法是6个参数,检查一下,不要少传或多传了。

4、编译错误:

对于ServletRegistrationBean(com.alibaba.druid.support.http.StatViewServlet,java.lang.String), 找不到合适的构造器

druid版本升级到1.2.18,com.alibaba.druid.support.http.StatViewServlet 改为 com.alibaba.druid.support.jakarta.StatViewServlet

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.2.18</version>
</dependency>

5、编译错误:

不兼容的类型: com.alibaba.druid.support.http.WebStatFilter无法转换为jakarta.servlet.Filter

同上,druid版本升级到1.2.18,com.alibaba.druid.support.http.WebStatFilter 改为 com.alibaba.druid.support.jakarta.WebStatFilter 

6、mybatis版本问题:

java.lang.NoClassDefFoundError: org/springframework/core/NestedIOException

需要升级mybatis的版本 ,对应版本如下:

您可能感兴趣的与本文相关的镜像

AutoGPT

AutoGPT

AI应用

AutoGPT于2023年3月30日由游戏公司Significant Gravitas Ltd.的创始人Toran Bruce Richards发布,AutoGPT是一个AI agent(智能体),也是开源的应用程序,结合了GPT-4和GPT-3.5技术,给定自然语言的目标,它将尝试通过将其分解成子任务,并在自动循环中使用互联网和其他工具来实现这一目标

<think>好的,用户想将Spring Boot 2.x升级3.x,需要了解迁移指南和改动点。首先,我应该回顾一下官方文档和相关引用内容。根据引用[1],Spring Boot 3.x引入了自动配置加载机制的变更,用新的imports文件替代了spring.factories。这点很重要,需要提醒用户更新配置。 接下来是JDK版本的问题,引用[2]提到Spring Boot 2.x需要JDK 8,而3.x可能需要更高的版本,比如JDK 17。用户需要先检查并升级JDK环境。 然后,依赖管理方面,Spring Boot 3.x可能更新了依赖库的版本,比如Spring Framework 6.x,Tomcat、Hibernate等。用户需要调整pom.xml中的版本号,确保兼容性,如引用[3]所示。 Jakarta EE的包名变化也是一个关键点,从javax.*改为jakarta.*,这会影响很多导入语句,用户需要全局替换或者使用迁移工具处理。 另外,配置属性的变更可能涉及,比如旧的属性被废弃或重命名。用户需要检查application.properties或.yml文件,替换成新的属性名称。 测试和验证步骤也很重要,升级后要运行测试用例,确保功能正常,尤其是自动配置和依赖注入的部分。可能还需要处理废弃的API,替换成推荐的新方法。 最后,用户可能需要参考官方迁移指南和社区资源,解决升级过程中遇到的具体问题。整理这些步骤时,要分点说明,结构清晰,让用户能一步步跟随操作。</think>### Spring Boot 2.x 升级3.x 的迁移指南和改动点 #### 1. **环境要求升级** - **JDK版本**:Spring Boot 3.x 要求 **JDK 17+**,而 Spring Boot 2.x 支持 JDK 8+。需先升级本地开发环境和生产环境的JDK版本[^2]。 - **Jakarta EE 支持**:Spring Boot 3.x 使用 Jakarta EE 9+,所有 `javax.*` 包名替换为 `jakarta.*`(例如 `javax.servlet` → `jakarta.servlet`)[^1]。 #### 2. **依赖和配置变更** - **自动配置加载机制**: Spring Boot 3.x 弃用 `META-INF/spring.factories`,改为使用 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` 文件定义自动配置。需检查自定义 Starter 项目是否适配此变更。 - **依赖版本升级**: - Spring Framework 6.x - Tomcat 10.x(需适配 Jakarta EE 包名) - Hibernate 6.x - Thymeleaf 3.1.x - 其他三方库需检查兼容性(例如 Flyway、Lombok)。 #### 3. **代码适配** - **包名替换**:全局替换代码中 `javax.*` 为 `jakarta.*`,尤其是以下模块: ```java // 旧版 import javax.servlet.http.HttpServletRequest; // 新版 import jakarta.servlet.http.HttpServletRequest; ``` - **废弃的配置属性**:部分配置属性已重命名或废弃,例如: - `server.max-http-header-size` → `server.max.http.header.size` - 需检查 `application.properties` 或 `application.yml` 中的属性兼容性。 #### 4. **构建工具调整** 在 `pom.xml` 中升级 Spring Boot 版本: ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.3.x</version> </parent> ``` 并更新相关依赖的版本号(如 `spring-boot-starter-web`、`spring-data-jpa`)[^3]。 #### 5. **测试与验证** - **单元测试**:运行现有测试用例,确保依赖注入和自动配置正常。 - **兼容性检查**:使用 `./mvnw dependency:tree` 检查依赖冲突。 - **日志分析**:关注启动日志中关于废弃方法或配置的警告。 #### 6. **其他注意事项** - **GraalVM 原生镜像支持**:Spring Boot 3.x 增强了对 GraalVM 的支持,若需构建原生应用,需调整配置。 - **安全性变更**:Spring Security 6.x 可能引入新的鉴权流程,需适配 OAuth2、JWT 等模块。 ---
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值