百度360必应搜狗淘宝本站头条
python判断字典是否为空crontab每周一执行aes和des区别安装指定版本npmadb pull
当前位置：网站首页 > IT知识 > 正文

超上头!Spring Boot 2.X升级至3.X的注意事项及解决方案

liuian 2025-07-08 20:05 1 浏览

一、前置条件

JDK 版本要求

宝子们，升级 Spring Boot 3.X 的话，必须得用 JDK 17 以上的版本哦！像我，就果断选择了 JDK 21，毕竟它对 Spring AI 的支持超给力，能让咱在技术探索的道路上一路狂飙～

验证方式超简单，在命令行里输入：

java -version

轻松查看版本，是不是超酷！

构建工具兼容性

构建工具方面，Maven 得>= 3.6.3 。我用的是 apache - maven - 3.8.8，运行起来超顺滑，就像丝滑的巧克力，完全没卡顿，稳稳拿捏升级的前置条件。

SpringBoot3.X默认内嵌tomcat版本

服务器中间件方面Tomcat >=10.1.x(支持Servlet 5.0+)，可自己手工指定版本

<properties>

<tomcat.version>apache-tomcat-10.1.36</tomcat.version>

</properties>

二、核心变更适配

Jakarta EE 9+ 迁移

代码变化来咯，看这里：

- import javax.servlet.http.HttpServletRequest;

+ import jakarta.servlet.http.HttpServletRequest;

这一变动影响范围还挺广，Servlet API、JPA（从 javax.persistence 变为 jakarta.persistence ）、Bean Validation（从 javax.validation 变为 jakarta.validation ）都在其中。别慌，解决办法超简单，借助 IDE 的全量替换功能，一键把 javax. 替换成 jakarta.，轻松搞定，简直 yyds！

Spring Security 6.x 配置重构

代码风格大变身啦：

// 2.x旧写法（已经out啦）

@EnableWebSecurity

public class SecurityConfig extends WebSecurityConfigurerAdapter {

@Override

protected void configure(HttpSecurity http) throws Exception {

http.authorizeRequests().anyRequest().authenticated();

}

}

// 3.x新写法，更简洁更时尚

@Configuration

@EnableWebSecurity

public class SecurityConfig {

@Bean

public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {

return http

.authorizeHttpRequests(auth -> auth

.anyRequest().authenticated()

)

.build();

}

}

赶紧跟上这波时尚潮流，让代码也变得 “潮酷” 起来。

三、关键组件兼容性

组件

最低要求版本

注意事项

MySQL

8.0

方言类名变更（MySQL5Dialect → MySQLDialect）

Thymeleaf

3.1.x

严格模式模板校验

Spring Data JPA

3.0.x

分页查询返回类型变更（Page → Slice）

Spring Kafka

3.0.x

消费者位点管理策略调整

Spring Cloud

2022.0.x+

Bootstrap 上下文默认禁用

每个组件都有自己的 “小脾气”，升级时可一定要按照要求来，不然它就可能给你 “闹别扭” 哦。

四、分阶段升级策略

过渡阶段

当然要是求稳的话可以不要一下子把升级的版本跨度弄得太大，咱先升级到 Spring Boot 2.7.x（这可是 2.x 的最后一个版本哦），JDK版本先用11或者17，然后把所有弃用警告都清理干净，就像打扫房间一样，干干净净再继续新升级新的版本。

五、验证与监控

启动时版本验证

在代码里加上这个，启动时就能看到 Spring Boot 的版本啦：

@SpringBootApplication

public class Application {

public static void main(String[] args) {

System.out.println("Spring Boot Version: " + SpringBootVersion.getVersion());

SpringApplication.run(Application.class, args);

}

}

时刻掌握版本信息，升级更安心。

六、常见问题速查

错误现象

解决方案

java.lang.NoClassDefFoundError: jakarta/servlet/http/HttpServletRequest

检查是否遗漏 javax→jakarta 包名替换

Parameter 0 of constructor in ... required a bean of type ...

添加显式包扫描：@SpringBootApplication (scanBasePackages = {"com.***.***"})

Spring Security 6: AuthenticationManager cannot be cast to ...

使用新式配置注入 AuthenticationManager

项目中存在循环依赖(这是本次升级改造最难解决的问题)

看下方循环依赖问题解决方案

遇到问题别着急，按照这些解决方案，分分钟就能解决，让升级之路畅通无阻。

七、循环依赖问题解决方案

第一种 开启循环依赖（其实并没有根本解决问题,适合旧项目的升级改造，减少工作量）

Spring默认已经不在支持循环依赖，在配置文件中重新开启循环依赖支持

spring:

main:


allow-circular-references:true #允许循环引用


第二种 启动类mian方法改造（这个方法有个bug，如果项目用war包的方式打包，启动的时候还是会循环依赖的错误，用jar包的方式则不会）

new SpringApplicationBuilder(MssSvnApplication.class).allowCircularReferences(true).run(args);

第三种 使用懒加载标签

@Lazy // 使用懒加载

第四种 每次使用的时候就去Bean工厂里去获取，这样就不存在循环依赖了（网上介绍的方案感觉不是很靠谱）新项目有时间还是改代码从根本上解决问题

相关推荐

Python tkinter学习笔记(七):Notebook和Treeview

‘Pythontkinter’是Python自带的GUI工具包，非常适合开发小型的GUI应用。最近使用‘tkinter’开发了一些自己日常使用的小工具，效果不错，于是把开发过程中学习到的一些tkin...

如何用 Python实现简单的表格界面

Excel有表格编辑功能，为什么我还要弄一个，不是多此一举么。道理是对的，但是很多会员功能才更加强大，不是吗？我们学语言，一来可以练习编码熟练的，巩固知识点，更重要的是你熟悉开发，以后如果你想实现一...

土地增值税清算中的施工合同进行判断是否有重复施工的情况

对土地增值税清算中的施工合同进行判断是否有重复施工的情况，使用Python中的Pandas库对施工合同的相关数据进行处理，基于文本相似度进行判断。1.读取施工内容数据：将施工内容数据存储在一个...

大模型时代必备技能:Embedding与向量数据库开发完全指南

本文较长，建议点赞收藏，以免遗失。更多AI大模型应用开发学习视频及资料，尽在官网-聚客AI学院大模型应用开发微调项目实践课程学习平台一.Embeddings与向量数据库1.1Embeddings的...

分布式实时搜索和分析引擎——Elasticsearch

一、概述Elasticsearch是一个基于Lucene的搜索引擎。它提供了具有HTTPWeb界面和无架构JSON文档的分布式，多租户能力的全文搜索引擎。Elasticsearch是用Java开发的...

elasticsearch v9.0.0重磅发布!解锁最新核心特性与性能飞跃!

时隔3年，Elasticsearch迎来重大版本更新！基于Lucene10.1.0构建，9.0.0版本在AI搜索、安全分析、向量计算、集群管理等多个领域实现突破性升级版本亮点o新...

Java中间件-Elasticsearch（java中间件技术及其应用开发）

Elasticsearch是一个非常强大的搜索引擎。它目前被广泛地使用于各个IT公司。Elasticsearch是由Elastic公司创建。它的代码位于GitHub-elastic/...

知名互联网公司和程序员都看好的数据库是什么?

2017年数据库领域的最大趋势是什么？什么是最热的数据处理技术？学什么数据库最有前途？程序员们普遍不喜欢的数据库是什么？本文都会一一揭秘。大数据时代，数据库的选择备受关注，此前本号就曾揭秘国内知名互联...

快速了解Elasticsearch（快速了解词语浑话的读音、释义等知识点）

Elasticsearch是一款基于Lucene的开源分布式全文搜索引擎，它支持实时搜索，具有优秀的可扩展性和可靠性。作为一款搜索引擎，Elasticsearch提供了丰富的API，使得开发人员可以通...

面试官:Kafka和ES选主有什么区别?

Kafka和ES都是用来处理大数据的中间件，一个是消息中间件的代表（Kafka），另一个是大数据搜索引擎的代表（ES）。它们在Java领域的使用非常广泛，在大数据方面就更不用说了，但它们的选...

ElasticSearch 23 种映射参数详解

ElasticSearch系列教程我们前面已经连着发了四篇了，今天第五篇，我们来聊一聊Es中的23种常见的映射参数。针对这23种常见的映射参数，松哥专门录制了一个视频教程：视频链接:...

还不会Elasticsearch?看这些知识入门刚刚好

作者：MacroZheng链接：https://juejin.im/post/5e8c7d65518825736512d097记得刚接触Elasticsearch的时候，没找啥资料，直接看了遍Ela...

Elasticsearch学习，请先看这一篇!

题记：Elasticsearch研究有一段时间了，现特将Elasticsearch相关核心知识、原理从初学者认知、学习的角度，从以下9个方面进行详细梳理。欢迎讨论……0.带着问题上路——ES是如何产...

Elasticsearch企业级应用全景图:原理/场景/优化/避坑四重奏

一、核心概念与架构原理1.基本定义Elasticsearch是基于ApacheLucene构建的分布式实时搜索与分析引擎，具有以下核心特性：分布式架构：支持PB级数据水平扩展近实时（NRT）：数据...

ELK Stack系列之基础篇(八) - Elasticsearch原理总结(图示)

前言通过前面的知识，我们已经了解到了ELk到底是什么、以及他们的工作原理、ES集群架构、专有名词的一些解释。在进入下一阶段ES实操学习环节前，那么今天我将以图解的方式将ELK重点以及ES的相关逻辑进行...

一周热门
最近发表
标签列表