Spring Boot3.0升级,踩坑之旅,附解决方案

Spring Boot3.0正式发布及新特性解读 阅读详情
AI摘要

本文基于newbeemall项目总结Spring Boot 3.0升级的问题及解决办法。包括编译时servlet包名修改报错、Thymeleaf等依赖包升级导致代码写法过期报警、第三方库starter依赖失效、Mybatis Plus依赖问题等,并针对各问题给出了相应的解决措施。

本文基于 newbeemall 项目升级Spring Boot3.0踩坑总结而来,附带更新说明:

Spring-Boot-3.0-发布说明

Spring-Boot-3.0.0-M5-发布说明

一. 编译报错,import javax.servlet.*;不存在

这个报错主要是Spring Boot3.0已经为所有依赖项从 Java EE 迁移到 Jakarta EE API,导致 servlet 包名的修改,Spring团队这样做的原因,主要是避免 Oracle 的版权问题,解决办法很简单,两步走:

1 添加 jakarta.servlet 依赖

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
</dependency>
复制代码
  1. 修改项目内所有代码的导入依赖
修改前:
import javax.servlet.*
修改后:
import jakarta.servlet.*
复制代码

二. 附带的众多依赖包升级,导致的部分代码写法过期报警

2.1 Thymeleaf升级到3.1.0.M2,日志打印的报警

14:40:39.936 [http-nio-84-exec-15] WARN  o.t.s.p.StandardIncludeTagProcessor - [doProcess,67] - [THYMELEAF][http-nio-84-exec-15][admin/goods/goods] Deprecated attribute {th:include,data-th-include} found in template admin/goods/goods, line 4, col 15. Please use {th:insert,data-th-insert} instead, this deprecated attribute will be removed in future versions of Thymeleaf.
14:40:39.936 [http-nio-84-exec-15] WARN  o.t.s.p.AbstractStandardFragmentInsertionTagProcessor - [computeFragment,385] - [THYMELEAF][http-nio-84-exec-15][admin/goods/goods] Deprecated unwrapped fragment expression "admin/header :: header-fragment" found in template admin/goods/goods, line 4, col 15. Please use the complete syntax of fragment expressions instead ("~{admin/header :: header-fragment}"). The old, unwrapped syntax for fragment expressions will be removed in future versions of Thymeleaf.
复制代码

可以看出作者很贴心,日志里已经给出了升级后的写法,修改如下:

修改前:
<th:block th:include="admin/header :: header-fragment"/>
修改后:
<th:block th:insert="~{admin/header :: header-fragment}"/>
复制代码

2.2 Thymeleaf升级到3.1.0.M2,后端使用thymeleafViewResolver手动渲染网页代码报错

// 修改前 Spring Boot2.7:
WebContext ctx = new (request, response,
        request.getServletContext(), request.getLocale(), model.asMap());
html = thymeleafViewResolver.getTemplateEngine().process("mall/seckill-list", ctx);
复制代码

上述代码中针对 WebContext 对象的创建报错,这里直接给出新版写法

// 修改后 Spring Boot3.0:
JakartaServletWebApplication jakartaServletWebApplication = JakartaServletWebApplication.buildApplication(request.getServletContext());
WebContext ctx = new WebContext(jakartaServletWebApplication.buildExchange(request, response), request.getLocale(), model.asMap());
html = thymeleafViewResolver.getTemplateEngine().process("mall/seckill-list", ctx);
复制代码

三. 大量第三方库关于Spring Boot的starter依赖失效,导致项目启动报错

博主升级到3.0后,发现启动时,Druid 数据源开始报错,找不到数据源配置,便怀疑跟 Spring boot 3.0 更新有关

这里直接给出原因:Spring Boot 3.0 中自动配置注册的 spring.factories 写法已废弃,改为了
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 写法,导致大量第三方 starter 依赖失效

在吐槽一下,这么重要的更改在Spring官方的 Spring-Boot-3.0-发布说明 中竟然没有,被放在了 Spring-Boot-3.0.0-M5-发布说明 中

这里给出两个解决方案:

  1. 等待第三方库适配 Spring Boot 3.0
  2. 按照 Spring Boot 3.0要求,在项目resources 下新建 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件,手动将第三方库的 spring.factories 加到 imports 中,这样可以手动修复第三方库 spring boot starter 依赖失效问题

四. Mybatis Plus 依赖问题

Mybatis plus 最新版本还是3.5.2,其依赖的 mybatis-spring 版本是2.2.2(mybatis-spring 已经发布了3.0.0版本适配 Spring Boot 3.0),这会导致项目中的sql查询直接报错,这里主要是因 Spring Boot 3.0中删除 NestedIOException 这个类,在 Spring boot 2.7中这个类还存在,给出类说明截图

这个类在2.7中已经被标记为废弃,建议替换为 IOException, 而 Mybatis plus 3.5.2中还在使用。这里给出问题截图
MybatisSqlSessionFactoryBean 这个类还在使用 NestedIOException

查看 Mybatis plus 官方issue也已经有人提到了这个问题,官方的说法是
mybatis-plus-spring-boot-starter 还在验证尚未推送maven官方仓库,这里我就不得不动用我的小聪明,给出解决方案:

  1. 手动将原有的 MybatisSqlSessionFactoryBean 类代码复制到一个我们自己代码目录下新建的 MybatisSqlSessionFactoryBean 类,去掉 NestedIOException 依赖
  2. 数据源自动配置代码修改
@Slf4j
@EnableConfigurationProperties(MybatisPlusProperties.class)
@EnableTransactionManagement
@EnableAspectJAutoProxy
@Configuration
@MapperScan(basePackages = "ltd.newbee.mall.core.dao", sqlSessionFactoryRef = "masterSqlSessionFactory")
public class HikariCpConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }


    @Bean(name = "masterDataSource")
    @ConfigurationProperties(prefix = "spring.datasource.master")
    public DataSource masterDataSource() {
        return new HikariDataSource();
    }

    /**
     * @param datasource 数据源
     * @return SqlSessionFactory
     * @Primary 默认SqlSessionFactory
     */
    @Bean(name = "masterSqlSessionFactory")
    public SqlSessionFactory masterSqlSessionFactory(@Qualifier("masterDataSource") DataSource datasource,
                                                     Interceptor interceptor,
                                                     MybatisPlusProperties properties) throws Exception {
        MybatisSqlSessionFactoryBean bean = new MybatisSqlSessionFactoryBean();
        bean.setDataSource(datasource);
        // 兼容mybatis plus的自动配置写法
        bean.setMapperLocations(properties.resolveMapperLocations());
        if (properties.getConfigurationProperties() != null) {
            bean.setConfigurationProperties(properties.getConfigurationProperties());
        }
        if (StringUtils.hasLength(properties.getTypeAliasesPackage())) {
            bean.setTypeAliasesPackage(properties.getTypeAliasesPackage());
        }
        bean.setPlugins(interceptor);
        GlobalConfig globalConfig = properties.getGlobalConfig();
        bean.setGlobalConfig(globalConfig);
        log.info("------------------------------------------masterDataSource 配置成功");
        return bean.getObject();
    }

    @Bean("masterSessionTemplate")
    public SqlSessionTemplate masterSessionTemplate(@Qualifier("masterSqlSessionFactory") SqlSessionFactory sqlSessionFactory) {
        return new SqlSessionTemplate(sqlSessionFactory);
    }

}
复制代码

到这里,项目就能够正常跑起来了

总结

Spring Boot 3.0 升级带来了很多破坏性更改,把众多依赖升级到了最新,算是解决了一部分历史问题,也为了云原型需求,逐步适配 graalvm ,不管怎么样作为技术开发者,希望有更多的开发者来尝试 Spring Boot 3.0 带来的新变化。

SpringBoot3.0新特性:1、spring.factories文件废弃,自动配置包位置变化 2、Spring Native 快速体验 3、jakata api迁移 3、三方库的支持 阅读详情

相关推荐

【SpringBoot3】Spring Boot 3.0 集成 Mybatis Plus

MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。

不积跬步无以至千里,不积小流无以成江海。一个喜欢学习分享的程序员 1万+

Springboot学习3.0

springboot3 学习笔记

yueyie的博客 6667

spring cloud项目升级spring boot 2.0爬过的坑

注:升级后spring boot为2.0版本,spring cloud为Finchley.M8版本。 2.0官方文档地址:https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/ gitee项目地址:https://gitee.com/lwydyby/springcloud-adplatform 升级时,官方建...

万万没想到的博客 1万+

【SpringBoot3】Spring Boot 3.0 介绍以及新特性

Spring Boot 3.0 是 Spring Boot 框架的一个重要版本,它在保持了 Spring Boot 的一贯优点的同时,也进行了一些重要的改进和更新。 Spring Boot 3.0 对 Java 版本的要求进行了更新。这个版本要求使用 **Java 17** 作为最低版本,以利用最新的语言特性和性能改进。如果你正在使用的是 Java 8 或 Java 11,则需要先升级 JDK 版本,然后再开发 Spring Boot 3.0 应用程序。

不积跬步无以至千里,不积小流无以成江海。一个喜欢学习分享的程序员 1万+

Spring Boot 3.2+ 升级Mybatis-Plus 3.5.x 兼容性问题与解决方案Invalid value type for attribute ‘factoryBeanObjectT

通过替换 Starter 或精准控制依赖版本,我们成功跨越了 Spring Boot 3.2+ 与 Mybatis-Plus 的兼容鸿沟。

z2637305611的博客 3130

Spring 6.0+Boot 3.0实战避坑全指南:5大类高频问题与解决方案(附代码示例)

先读官方迁移指南:Spring官方提供了详细的迁移文档(Spring Boot迁移指南),重点关注“Breaking Changes”章节,明确版本变更点(如JDK要求、包名迁移、配置项变更),避免盲目上手。渐进式升级:不建议直接对旧项目全量升级,可按以下步骤推进: 阶段1:升级JDK至17+,确保项目在旧框架版本下可正常运行;阶段2:升级Spring Boot至3.x(暂不启用Spring 6新特性),解决依赖冲突与包名迁移;

srlsong的博客 1006

Spring Boot3.0升级,踩坑之旅,附解决方案(二)

项目中使用了 com.github.whvcse包的easy-captcha 验证码依赖,升级至Jdk17后,验证码接口报错:Cannot invoke "javax.script.ScriptEngine.eval(String)" because "engine" is null,错误原因很明显脚本引擎执行脚本语句报错,因为执行引擎为空。查询相关资料Jdk8自带的JavaScript引擎 nashorn 再升级到Jdk9后就被移除了,从而导致报错

fzlhz的博客 1447

Spring Boot 2.7.18 升到 3.5.8,我踩了这些坑(附完整升级指南)

Spring Boot 2.7.18 到 3.5.8 的升级是一次全方位的技术栈更新,虽然改造面较广,但带来的收益也很明显:✅性能提升:JDK 17 的 ZGC 垃圾回收器大幅降低停顿时间✅安全增强:Spring Security 6 默认配置更安全✅生态支持:获得最新的 Spring Cloud 和 Alibaba 组件支持✅未来保障:Spring Boot 3.x 是长期支持版本升级建议循序渐进:先升级框架,再改造业务充分测试:重点关注权限和配置分模块实施:按模块逐步替换,降低风险。

充电桩 1252

简谈Spring Boot3.0升级后的踩坑之旅,另附解决方案!

Spring Boot 3.0 升级带来了很多破坏性更改,把众多依赖升级到了最新,算是解决了一部分历史问题,也为了云原型需求,逐步适配 graalvm ,不管怎么样作为技术开发者,希望有更多的开发者来尝试 Spring Boot 3.0 带来的新变化。 修改项目内所有代码的导入依赖 二. 附带的众多依赖包升级,导致的部分代码写法过期报警 2.1 Thymeleaf升级到

Javatutouhouduan的博客 4233

Spring Boot 3.x微服务升级经历

Spring Boot 3.0.0 GA版已经发布,好多人也开始尝试升级,有人测试升级后,启动速度确实快了不少,如下为网络截图,于是我也按捺不住的想尝试下。

分享技术干货和灵感、推荐新书和好玩的项目、分享Java面试题 9272

用Linkboy玩转Arduino:3小时搞定智能倒车雷达(附仿真文件下载)

本文详细介绍了如何利用Linkboy图形化编程工具,在3小时内快速搭建一个基于Arduino的智能倒车雷达项目。通过仿真环境,初学者无需硬件即可学习超声波测距原理、报警逻辑设计,并完成从虚拟仿真到实体硬件的完整流程。文章提供了清晰的步骤、调试技巧及功能扩展思路,并附有仿真文件,是入门Arduino和智能硬件制作的绝佳实践指南。

weixin_29159441的博客 405

[Java] Spring Boot 3.0 升级 实战踩坑记录

Spring Boot常用于Java后端开发,于2022年11月24日正式发布了3.0.0版本,带来了全新的特性、升级了依赖版本乃至Java版本,与此同时也弃用或更改了一些旧版本中的写法,导致了需要修改代码或配置文件。笔者尝鲜去升级了一下Spring Boot 3.0,本篇文章将会简要归纳总结一下笔者在升级的时候需要进行的操作、遇到的问题和解决方案,希望能对各位读者有所帮助。

gooding300的博客 3868

Spring Boot 2 升级 Spring Boot 3 踩坑实战:MyBatis-Plus、MySQL、Redis 迁移总结

文章摘要 Spring Boot 2升级到Spring Boot 3是一次涉及JDK、Spring框架和Jakarta EE的全方位迁移。升级路径建议先从Spring Boot 2.x升级到2.7.x,解决兼容性问题后再迁移到3.x。关键注意事项包括:JDK必须升级到17+;javax包名全面改为jakarta;MyBatis-Plus需使用专用starter(mybatis-plus-spring-boot3-starter);MySQL驱动坐标改为com.mysql:mysql-connector-j;

m0_60277481的博客 520

AXI Timer IP核使用说明

AXI Timer是提供定时技术功能的集成IP核,具有时间生成、事件捕获、产生PWM波以及产生中断的功能,下面具体讲述Timer IP核的使用说明。

weixin_43418104的博客 2489

如何区分Info与CoWoS封装?

这篇文章主要从Info、CoWoS封装的定义、Interposer的种类以及Info、CoWoS封装的种类三方面进行了介绍,希望读者能够有所收获

wangyubo1的博客 7942

Spring Boot 2.7 升级 Spring Boot3.2.1 踩坑指南

本文是关于将 Java Spring Boot 2.7项目升级至Spring Boot 3.2.1 版本的踩坑指南。文档详细介绍了对 javax 系列依赖的替换、邮件相关依赖、Swagger 的升级、第三方依赖的版本升级、Spring Boot 配置变动等多方面的操作。通过本文,您可以更轻松地完成 Spring Boot 项目的升级,优化内存占用,提升系统性能。

qq_42051837的博客 3674

Lumerical官方案例、FDTD时域有限差分法仿真学习(十三)——多模干涉耦合器(MMI)

计算通过 1×2 端口多模干涉 (MMI) 耦合器的宽带传输和光损耗。 使用设备 S 参数在 INTERCONNECT 中创建 MMI 的紧凑模型。 它还展示了如何使用 CML 编译器提取这些参数以生成紧凑模型。 一、概述 了解模拟工作流程和关键结果 低损耗光合路器和分路器是基于 Mach-Zehnder 的光调制器的基本组件,并且是集成电路的关键组成部分。通过在输入/输出波导处使用线性锥形确保输入/输出波导的模式与干涉区域之间的

weixin_45719141的博客 1万+

Spring Boot 3.0 重磅升级实战:性能飙升5倍的新特性,你跟上没?

Spring Boot 3.0 的升级不仅是技术迭代,更是架构思维的转变。GraalVM 原生镜像将彻底改变 Java 在云原生领域的地位,而 Jakarta EE 10 的全面支持则为微服务开发注入新活力。你的项目准备升级了吗?欢迎在评论区讨论遇到的坑!相关资源Spring Boot 3.0 官方迁移指南。

TGQlovemm的博客 1450

对E-R模型向关系模式转换的认识

一:基本E-R图的转换 1     属性处理 派生属性:直接忽略。 复合属性:展平技术。 多值属性:单独建立一个关系表,关系名就是多值属性名,如果是实体集的多值属性,关系的属性就是实体集的码加上多值属性,如果是联系集的多值属性,关系的属性就是各个实体集的码加上多值属性,关系的码要具体情况具体分析。 2     基本E-R图转换为关系模式 强实体集:一个关系,关系名就是强实体集名,关系属

优快云_LYY的专栏 2734

文献解读:结构方程模型SEM基础,小白看这个就基本够了

今天要解读的依然是一篇教学文献:The Basics of Structural Equation Modeling,文献作者是Diana Suhr, Ph.D. University of Northern Colorado。 文献链接: https://www.lexjansen.com/wuss/2006/tutorials/TUT-Suhr.pdf 结构方程模型是: 用来检验显变量与潜变量关系假设的综合性的统计技巧 用来表示,估计或者检验变量间理论关系的技巧 用来探究一系列潜变量和显变量因

Codewar的博客 6万+

Spring Boot 3 踩坑指南 —— 从 2 升级到 3 遇到的 Redis、MyBatis-Plus 等问题及解决方案

在这个过程中,我从一开始完全依赖搜索,到现在能定位问题关键点,自己分析可能原因,再有针对性地问 GPT 或查文档,明显感觉自己成长了!遇到问题别慌,看错误栈,看关键组件,看配置,看版本,享受解决问题的喜悦吧!

weixin_44146541的博客 1052

Camunda 7.x 系列【22】全局监听器

Camunda支持义一个全局ExecutionListener和一个全局TaskListener,会捕获流程中发生的所有事件的通知,这样可以定义一个全局的审批人检查监听器,作用于所有用户任务。

记录知识、锤炼自我 2942

Spring Boot 升级踩坑:从 2.x 到 3.x 迁移过程中的常见问题

Spring Boot 3.x 的升级不是一个“随手点升级”的小活儿,而是一次生态级别的迁移。Java 17 要求Jakarta 命名空间迁移第三方依赖兼容性如果你正在维护一个长期运行的 Spring Boot 2.x 项目,升级前一定要有详细的迁移计划与测试保障。一旦顺利迁移,你将获得更现代化的生态、更强的性能优化,以及与未来云原生场景更好的兼容性。

m0_65592409的博客 1871

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

上一篇: 突破Java职业天花板:架构师必掌握的微服务、大数据与高并发解决方案
下一篇: Redis原理 - 对象的数据结构SDS、Inset、Dict、ZipList、QuickList
程序员职业指南
博客等级 码龄4年 2139粉丝 960原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值