Spring Boot 3.0 现已正式发布,它包含了 12 个月以来 151 个开发者的 5700 多次代码提交。这是自 4.5 年前发布 2.0 以来,Spring Boot 的第一次重大修订。
它也是第一个支持 Spring Framework 6.0 和 GraalVM 的 Spring Boot GA 版本,同时也是第一个基于Java 17的Spring Boot版本,以Jakarta EE 9为基准并支持Jakarta EE 10。同时借助于GraalVM支持了AOT和Native Image。
3.0升级指南如果你想尝试Spring Boot 3.0,不妨参考胖哥精心准备的升级指南。
升级JDK首先要升级你的JDK到JDK17,如果你要使用Native Image特性,要使用GraalVM 22.3以上和 Native Build Tools Plugin 0.9.17 或更高的版本。
平滑升级这里不建议直接从低于Spring Boot 2.7的版本直接升级到Spring Boot 3.0。不然新特性和API变更太多,就需要你修改大量的配置,升级路径会过于陡峭。建议通过小版本号分阶段升级到2.4、2.6、2.7,最后再到3.0。
依赖评估Spring Boot3.0下依赖组件的版本要求也不尽相同,比如Spring Boot Kafka Starter可能对Kafka有什么要求,这要求你进行充分评估。Spring Cloud体系应该在对应的Spring Boot 3.0体系发布后进行升级。
升级到Spring Boot 3一旦上面的工作准备完毕,你就可以开始尝试升级到Spring Boot 3.0了。
配置属性兼容在Spring Boot 3.0中,一些配置属性被重新命名/删除了,开发人员需要相应地更新他们的application.properties
或者application.yml
。为了帮助你做到这一点,Spring Boot 3.0提供了一个spring-boot-properties-migrator
模块。一旦作为依赖关系添加到你的项目中,它不仅会在启动时分析你的应用程序的环境并打印诊断结果,而且还会在运行时为你临时迁移属性。把下面这个加入pom.xml
以帮助你升级兼容配置属性:
org.springframework.boot spring-boot-properties-migratorruntime
❝Jakarta EE完成迁移之后,务必要移除
spring-boot-properties-migrator
依赖。
由于Java EE已经变更为Jakarta EE,包名以javax
开头的需要相应地变更为jakarta
。这里建议通过Intellij IDEA 2021.2提供的内置功能批量处理即可:
❝升级的关键变更当然你也可以手动去变更包名。
Spring Boot 3.0有一些关键改变,这些改变将与大多数应用程序有关。所以开发者要仔细阅读这些变更。
图片Banner不再支持现在Spring Boot 3.0自定义Banner只支持文本类型(banner.txt
),不再支持图片类型。
Logback和Log4j2的日志消息的日期和时间部分的默认格式已经改变,以符合ISO-8601标准。新的默认格式yyyy-MM-dd'T'HH:mm:ss.SSSXXX
使用T
来分隔日期和时间,而不是空格字符,并在最后添加时区偏移。LOG_DATEFORMAT_PATTERN
环境变量或logging.pattern.dateformat
属性可以用来恢复以前的默认值yyyy-MM-dd HH:mm:ss.SSS
。
配置属性类注解@ConfigurationProperties
默认情况下不再需要使用@ConstructorBinding
来标记构造,你应该从配置类上移除它,除非该配置类多个构造函数来明确配置属性绑定。
因为SnakeYAML
的JSON
解析与其他解析器的实现不一致。如果你直接使用YamlJsonParser
,请迁移到其他JsonParser
实现中。
Spring Boot 2.7引入了一个新的文件:
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
用于注册自动配置,同时保持与spring.factories
中注册的向后兼容。Spring Boot 3.0发布后,spring.factories
已经被移除,只能通过imports
文件来注册自动配置。
现在Spring MVC和Spring Webflux 的路径匹配规则已经做了调整,默认情况下尾部斜杠/
的匹配机制将和以前不同:
3.0以前/foo/bar
等同于/foo/bar/
3.0以后/foo/bar
不同于/foo/bar/
server.max-http-header-size
已经被弃用,现在用server.max-http-request-header-size
替代 ,并且现在该属性只能来配置请求头的大小,不再限制某些Web容器的响应头大小,如果需要限制响应头大小请通过自定义WebServerFactoryCustomizer
来实现。
优雅停机由SmartLifecycle
实现,在SmartLifecycle.DEFAULT_PHASE - 2048
阶段开始,Web服务器在SmartLifecycle.DEFAULT_PHASE - 1024
阶段停止。任何参与优雅关机的SmartLifecycle实现都应该被相应地更新。
由于Jetty目前还不支持Servlet 6.0,使用Jetty的开发者需要通过降低Jakarta Servlet的版本为5.0。
数据访问相关的变更spring.data
前缀已被保留给Spring Data项目,如果你使用了Spring Data项目的子项目,application.yaml
中相关的配置属性就需要响应的变更。例如spring.redis
现在需要修改为spring.data.redis
。
数据访问相关的组件现在都使用了比较新的版本:
Flyway更新到 9.0
Hibernate 更新到 6.1
R2DBC 更新到 1.0
另外 Flapdoodle 嵌入式 MongoDB 的自动配置被移除,开发者有需要的话需要自行引入。
ElasticsearchElasticsearch的Rest客户端采用了新的API实现,旧的自动配置和Spring Data Elasticsearch中旧的客户端API已经被移除。
Spring Security相关的变更,胖哥稍后会整理并独立分享。
其它变更可观测性、度量跟踪、Maven、Gradle也都有不同程度的变更,有需要可以查看官方的Spring-Boot-3.0-Migration-Guide 。
记得收藏这一篇,后续胖哥会深入Spring 6.0和Spring Boot 3.0的细节部分。
你是否还在寻找稳定的海外服务器提供商?创新互联www.cdcxhl.cn海外机房具备T级流量清洗系统配攻击溯源,准确流量调度确保服务器高可用性,企业级服务器适合批量采购,新人活动首月15元起,快前往官网查看详情吧