Spring Boot 3.0.0正式发布，Banner不再支持图片&增强可观测性

本文已被https://yourbatman.cn收录；女娲Knife-Initializr工程可公开访问啦；程序员专用网盘https://wangpan.yourbatman.cn；技术专栏源代码大本营：https://github.com/yourbatman/tech-column-learning；公号后台回复“专栏列表”获取全部小而美的原创技术专栏

你好，我是YourBatman：一个俗人，贪财好色。

Title	Link
所属专栏	[YourBatman]-资讯/新特性，[YourBatman]-Spring技术栈新特性
源代码	https://github.com/yourbatman/FXP-java-ee
程序员专用网盘公益上线啦，注册送1G超小容量，帮你实践做减法	https://wangpan.yourbatman.cn
Java开发软件包(Mac)	https://wangpan.yourbatman.cn/s/rEH0 提取码：javakit
女娲工程	http://152.136.106.14:8761
版本约定	[Mac OS 13.0.1]，[IDEA 2022.3]

????前言

2014年发布Spring Boot 1.0；
2018年发布Spring Boot 2.0；
2022年发布Spring Boot 3.0；
这节奏，是要跟世界杯/奥运会的频率杠上呀？

PS：本届世界杯三颗巨星已走俩，期待Messi

北京时间2022-11-24，Spring Boot 3.0.0正式发布。回忆一下上次发版还是上次，幸好笔者有记录：

• Spring Boot 3.0.0正式发布，Banner不再支持图片&增强可观测性
  • 北京时间2022-11-24
• Spring Boot 2.7.0正式发布，弃用从spring.factories加载自动配置类
  • 北京时间2022-05-19
• Spring Boot 2.6.0正式发布，循环引用终于被禁
  • 北京时间2021-11-17
• Spring Boot 2.5.0正式发布，环境变量可指定前缀的功能很赞
  • 北京时间2021-05-21
• Spring Boot 2.4.0正式发布，全新的配置文件加载机制
  • 北京时间2020-11-12
• Spring Boot 2.3.0正式发布：优雅停机、配置文件位置通配符
  • 北京时间2020-05-15

Spring Boot 3.0.0是是首个支持Spring Framework 6以及支持GraalVM的版本。官方对各个版本支持时间表：

✍正文

如果把2014年发布1.0版比作Spring团队的再次创业，发布后火爆程度可谓风靡全球。到2018年发布2.0版本，已经完全没有对手了。今年刚发布的3.0版本直接上Java 17以及Jakarta EE 9起步，可谓站稳脚跟后的引领风骚。

????what’s new（新特性）

老规矩，将我们关心的功能爽一遍。

????最低版本要求

Spring Boot 3.0.0对外部依赖有最低版本要求：

1. JDK 17
2. Graal 22.3
3. Native Build Tools Plugin 0.9.17
4. Spring Framework 6

????借助Micrometer大大提升可观测性

据说，Spring Boot内部有专门一个“团队”来做应用的可观性，本次的借助Micrometer的升级，使得可观测这件事在Spring Framework 6和Spring Boot 3.0.0内部都变得更加简单、易用！通过可观测性，能更好的了解系统内部的运行状态，做到胸有成竹。

Micrometer 1.10中引入的新的Observation API，它使得一个API就能搞定：metrics、tracing、logging指标观测，并且还能传递上下文、传播元数据等等，对使用者非常友好。

这个API的设计是降低使用门槛，希望用户使用单一API，就能从中获取到多种信息：metrics、tracing、logging

笔者窥探了一下Spring Boot针对Micrometer源代码级别的变化，觉得值得用专题来做较为完整的表述，结合自己的一些使用经验，尽量去说清楚在项目中如何使用它来方便的观测你的Application。

????Log4j2增强

一句话：配置性更灵活、和Spring环境整合得更好了。

PS：一般情况下使用默认的logback即可。倘若你不是典型的高并发场景，不建议折腾Log4j2

????spring-web URL的匹配规则有变化

声明：这项特性更改和Spring Boot无关，属于Spring Framework 6的变更。

包含Spring MVC和WebFlux在内的URL 尾部斜杠 匹配方式，本次有调整：可参见PathMatchConfigurer类

为了下掉trailingSlashMatch这个属性，从Spring Framework 6开始将默认值由之前的true改为了fasle。虽然仅仅只是改了一个默认值，但这个变动其实还蛮大的，影响到了URL的匹配。

譬如，@GetMapping("/api/demo")之前版本即可匹配/api/demo亦可匹配上/api/demo/，自Spring Boot 3.0.0（其实是Spring Framework 6）版本后就不行了，只能匹配上前者，后者404。Spring Framework目前将此属性只标记为了@Deprecated(since = "6.0")过期，并未删除。因此若你从老项目里升级过来，那么请务必做好兼容，方式有两种：

1. 局部式：将需要兼容的接口URL显示的写出多个，如：@GetMapping({"/api/demo", "/api/demo/"})
2. 全局式：若需要“兼容”的接口过多，又或者没法逐一排查，那么可以使用下面这种全局兼容的方式：

@Configuration
public class YourWebConfiguration implements WebMvcConfigurer {

    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
      configurer.setUseTrailingSlashMatch(true);
    }

}

????删除对spring.factories自动配置的支持

在Spring Boot 2.7版本，引入了全新的INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件作为自动配置的文件，但那会依旧保留着对spring.factories的支持。关于此项变更的具体详情可参考笔者这篇文章：Spring Boot 2.7.0正式发布，弃用OkHttp 3、弃用spring.factories机制

到了Spring Boot 3.0.0版本，删除掉了spring.factories作为自动配置文件的支持。这个差异在AutoConfigurationImportSelector文件里体现出来：

值得注意的是：只是删除了spring.factories作为自动配置文件的支持，而不是不再支持这种SPI语法了。毕竟像什么EnvironmentPostProcessor、AutoConfigurationImportFilter、FailureAnalyzer等加载实现类的方式用spring.factories还是非常方便的。

Spring Boot此举，笔者觉得目的就想将自动配置文件的配置，和其它SPI配置分离（顺便做做简化），仅此而已

????@ConstructingBinding不能再标注在类上

从源代码的角度看，改注解已经不能再被标注在类上了（编译不通过）：

至于Spring Boot为何这么做？下面继续说完就懂了。

????改进的@ConstructorBinding检测能力

现在，当使用@ConfigurationProperties注解进行属性绑定时，如果类只有1个构造器，则可以省略注解@ConstructorBinding，不需要标注在构造器上。

PS：如果您有多个构造器，则仍然需要使用@ConstructorBinding来告诉 Spring Boot 使用哪一个

这样一句话描述体感还是不强，还是来个demo跑一跑。标注有@ConfigurationProperties注解的属性类（一般有称作属性类，不叫配置类），如下：

注：如下例中，此时笔者并未在这个唯一构造器里标注@ConstructorBinding注解

/**
 * 在此处添加备注信息
 *
 * @author YourBatman
 * @since 0.0.1
 */
@ToString
@ConfigurationProperties("demo")
public class DemoProperties {

    public DemoProperties(String name, Integer age) {
        this.name = name;
        this.age = age;
        System.out.println("DemoConfiguration初始化成功：" + this);
    }

    private String name;
    private Integer age;

}

配置文件里写好属性的k-v：

demo.name = YourBatman
demo.age = 18

通过@ConfigurationPropertiesScan将@ConfigurationProperties属性文件加载进容器：

/**
 * 在此处添加备注信息
 *
 * @author YourBatman
 * @since 0.0.1
 */
@ConfigurationPropertiesScan
@Configuration(proxyBeanMethods = false)
public class PropertiesConfiguration {

}

文件结构如下：

以上示例代码，在Spring Boot 2.7.x里运行结果为：报错

在Spring Boot 3.0.0版本运行结果为：正常

见识到了Spring Boot 3.0.0升级的威力。

令我，对于有多个构造器的case，笔者这里就不试了，建议有兴趣者自行动手跑跑Demo，加强理解比看文章100遍都强。

????题外话：@ConfigurationProperties使用最佳实践

先说一个数据：据笔者所见所闻，至少**95%**程序员使用@ConfigurationProperties的姿势是错的，并且不知道怎么做才是对的。

关于这个话题，在笔者之前有篇文章之前花大篇幅聊过，这里可再简单提一提，避免你在使用时候还出现些七七八八的问题。

比如上例中，如果我这么使用：如下截图，如果笔者没猜错的话，这大概率是你的使用方式吧

当然你可能不用构造器而是用get/set方法去处理，问题或许不会暴露出来，但不影响你继续往下看哈

从IDEA飘红提示来看，这种用法就不对嘛。再次运行容器：

在Spring Boot 2.7.x里运行结果为：报错

在Spring Boot 3.0.0版本运行结果为：报错

我在网上看到一篇写Spring Boot 3.0.0新特性的文章说到：改进的@ConstructorBinding检测能力这项新特性部分支持，不建议使用！嗨，这个误导性就比较强了。

说白了不是Spring Boot 3.0.0部分支持，而是使用者对属性类Bean的使用姿势不对：这从Spring Boot 3.0.0的报错提示能看出端倪，明显比2.7.x版本的报错指向性更好，明确告诉了你原因依旧修复方式。

值得一提的是，如果编码时这么使用，连IntelliJ IDEA都不同意：非常明显的指出了问题所在：

PS：想要获取IDEA这样温暖的提示，需要升级到最新版2022.3版本哦。关于此版本的新特性，可移步笔者这篇文章：IntelliJ IDEA 2022.3正式发布，配置云同步&支持Redis好用到炸

在属性类Bean上标注@Configuration注解（或者@Component及其所有派生注解），是大多数程序员的错误使用方式。因为这里其实犯了几大错误：

1. @ConfigurationProperties它并非一个Configuration配置类，因此不能直接走Spring Bean的初始化逻辑
2. @ConfigurationProperties类如果直接被实例化为Bean，将绕过了其特有的前置处理逻辑，造成逻辑缺失，也就会造成隐患bug
3. Spring Boot专门提供有@EnableConfigurationProperties和@ConfigurationPropertiesScan(since 2.2)注解来将@ConfigurationProperties类正确的放入容器内

倘若走捷径只需程序Run起来即可，那么这种问题积累多了，必将反噬。

如何发现最佳实践？对于Spring内部的组件，参考Spring Boot内置实现即可，它自己的东西自己的使用姿势就是绝对的权威。当然本质还是对实现原理的理解（但理解曲线比较长），有兴趣的可以看笔者之前的文章哈。

????Apache Kafka启用异步确认配置项

在KafkaProperties.Listener属性配置类里，新增了asyncAcks属性：

注意：此属性只在当KafkaProperties.Listener.ackMode = MANUAL/MANUAL_IMMEDIATE的时候才生效。

异步ack可对应Kafka中间件的同步(sync)、异步(async)、oneway三种发送方式理解。

????@SpringBootTest支持“调用”main方法

我们的Spring Boot应用入口是main方法，而@SpringBootTest测试时它并没有执行我main方法，而是自己启的容器。这对于有些在main方法还写了些代码逻辑（比如设置个系统属性啥的）的时候就比较难受了。

这次在@SpringBootTest注解上新增了一个属性：

它的含义为：

下面我们来体验一把：在main函数上输出一行日志

测试类：

运行测试类，日志为：

可以看到完完整整的执行了main方法（启动了应用），因此只要main方法能够执行到的代码、扫到的配置、加载到的Bean，都会被放入到测试上下文里。

????程序启动期间，不再查找主机名

2.7.x版本：启动日志包含主机名

3.0.0版本：启动日志不再包含主机名

代码差异体现在：

为何要干掉这段逻辑呢？看下这段代码的实现就知道了，还是比较耗时的：

这段逻辑干掉后，Spring Boot应用的启动速度应该会有比较明显的提升，收获比较大。

????不再使用JDK的SecurityManager

Java 17中，SecurityManager遭到弃用。同理，最低要求Java 17的Spring Boot 3.0.0也无理由再使用它了。

以Spring Boot的TomcatEmbeddedWebappClassLoader类举例：上下对比可看出区别

????Banner不再支持图片

先看看代码差异（上为2.7.x版本，下为3.0.0版本）：

可以看到，Spring Boot 3.0.0直接干掉了ImageBanner这个实现类。因此现在类路径下的banner.gif、banner.jpg、banner.png等图片文件都将被忽略，反馈归真，只支持文本类Banner了！

PS：有兴趣的同学可以看看ImageBanner的实现，很高级且很复杂，当然也很耗时。看完就明白这个版本为啥要干掉它了~

????JMX默认也只暴露Health端点了

从Spring Boot 2.7开始，web端点默认只暴露health，这次JMX也来跟着保持一致了。

如若需要显示控制其它端点，你可通过management.endpoints.jmx.exposure.include和management.endpoints.jmx.exposure.exclude属性来自定义控制。

????Actuator内置端点的返回JSON序列化统一使用ObjectMapper

在直线版本中，端点返回的序列化方式和MVC接口的并不一致，因此可能出现一些怪异现象。现在好了：所有端点的返回值序列化，统一使用ObjectMapper来完成。

这个标准是通过：统一实现OperationResponseBody接口实现的。

值得注意的事：若你有自定义的endpoint，那么也可通过实现OperationResponseBody接口，来保持和内置端点序列化的一致性。

????spring.data属性前缀改变

由于spring.data这个前缀保留给了Spring Data项目，因此之前Spring Boot上的有些配置需要做修改。

• spring.data.cassandra. -> spring.cassandra.
  • 解释：由于使用cassandra不需要引入spring data项目，因此它“不配”用spring.data前缀
• spring.redis. -> spring.data.redis.
  • 解释：由于使用redis会自动引入spring data项目依赖，因此需要统一到spring.data前缀
    

????其它升级/改版

• @AutoConfigureMetrics -> @AutoConfigureObservability
• @ConstructorBinding注解迁移到org.springframework.boot.context.properties.bind包了（之前版本在外层）
  • 从这点能看出框架对职责边界的强要求，日常点滴才能确保长久的不腐化
• DiskSpaceHealthIndicator详情里增加path的显示
  
• jakarta.validation.Configuration现在可借助ValidationConfigurationCustomizer定制化器进行定制了
• YamlJsonParser类被删除。原因为：SnakeYAML的JSON解析与其它JSON库的解析行为不一致，为了避免用错而导致问题，干脆删除掉。推荐使用JsonParser代替之
• 新增管理的组件：
  • EhCache 3
  • RxJava 3
• 移除管理的组件：
  • Apache ActiveMQ（可谓终于放弃了）
  • Atomikos（分布式事务管理器，支持XA协议）
  • EhCache 2（毕竟3.x已为主流）
  • Hazelcast 3
  • Apache Solr（因为它基于Jetty的客户端Http2SolrClient与Jetty 11不兼容）
  • RxJava 1.x和2.x
  • ANTLR 2

????Spring体系的其它依赖升级

基本上都是大版本号升级，毕竟命名空间从javax.* -> jakarta.*这一步影响还是蛮大的。

• Spring Data 2022.0
• Spring Kafka 3.0
• Spring REST Docs 3.0
• Spring Security 6.0
• Spring AMQP 3.0
• Spring Batch 5.0
• Spring GraphQL 1.1
• Spring HATEOAS 2.0
• Spring Integration 6.0
• Spring LDAP 3.0
• Spring Retry 2.0
• Spring Session 3.0
• Spring WS 4.0

????Jakarta依赖升级

Spring Boot管理上的为基于Jakarta EE 10（基线是Jakarta EE 9）

• Jakarta Persistence 3.1
• Jakarta Servlet 6.0
• Jakarta Validation 3.0
• Jakarta WebSocket 2.1
• Jakarta Activation 2.1
• Jakarta JMS 3.1
• Jakarta JSON 2.1
• Jakarta JSON Bind 3.0
• Jakarta Mail 2.1
• Jakarta Servlet JSP JSTL 3.0
• Jakarta Transaction 2.0
• Jakarta WS RS 3.1
• Jakarta XML SOAP 3.0
• Jakarta XML WS 4.0

????主要三方依赖升级

自从用上Spring Boot，程序员基本很少再需要关心三方依赖的版本号了，交给Spring Boot既省心又放心

早期程序员，应该有使用过spirng-bom的，深有体会。原来，Spring早就在筹划帮我们解决业务逻辑之外的痛点了

• Tomcat 10
• Jetty 11
• Undertow 2.2.20.Final
• Elasticsearch Client 8.5
• Hibernate Validator 8.0（实现了Jakarta Validation 3.0）
• Jackson 2.14
• Micrometer 1.10
• SLF4J 2.0（org.slf4j:slf4j-api:2.0.0）
• OkHttp 4.10（com.squareup.okhttp3:okhttp:4.10, 使用了kotlin封装）
• Netty 4.1.77.Final
• Couchbase Client 3.4
• Flyway 9
• Groovy 4.0
• Hibernate 6.1
• Jersey 3.1
• jOOQ 3.16
• Kotlin 1.7.20
• Liquibase 4.13
• Lettuce 6.2
• Log4j 2.18
• Logback 1.4
• Micrometer Tracing 1.0
• Neo4j Java Driver 5.2
• R2DBC 1.0
• Reactor 2022.0
• SnakeYAML 1.32
• Thymeleaf 3.1.0.M2

????总结

Spring Boot已然成为Java开发的基石，本次大版本升级，并且还是明确的阻断式的，因此可以看到大多建议都是清一色：正确的废话，所以笔者也来几句废话建议：

1. 生产环境非常确定的：不要用，不要用，不要用。至少等下一个中型版本出来后再考虑，也就是Spring Boot 3.1.x
   1. 因为不少依赖组件升级还没跟上（特别是国产的），比如典型的mybatis-plus、druid等
   2. 配置有较大变动，隐藏的坑多。如springsecurity、spring-data等
   3. Spring Cloud对应的版本（2022.0.0）还未Release
2. 个人自己：把玩，把玩，把玩。看10篇相关文章介绍，抵不上自己把玩一次！

技术向前的大船，浩浩荡荡不可逆。作为技术人，我们能做的是keep moving，不管是技术架构师还是业务架构师，还是开发工程师！

推荐阅读

• IntelliJ IDEA 2022.3正式发布，配置云同步&支持Redis好用到炸
• Spring Framework 6正式发布，携JDK 17&Jakarta EE开启新篇章
• IntelliJ IDEA 2022.2正式发布，支持Spring Boot 3和Spring 6
• JVM除了HotSpot，你还知道哪些？
• YourBatman用趣味代码雨祝你：端午安康
• 逐渐碎片化的Java生态圈：Oracle JDK、OpenJDK、阿里Dragonwell、华为毕昇

我是YourBatman：前25年不会写Hallo World、早已毕业的大龄程序员。高中时期《梦幻西游》骨灰玩家，网瘾失足、清考、延期毕业、房产中介、保险销售、送外卖…是我不可抹灭的黑标签

• ????2013.07 清考、毕业答辩3次未通过、延期毕业
• ????2013.08-2014.07 宁夏中介公司卖二手房1年，毕业后第1份工作
• ️️????2014.07-2015.05 荆州/武汉，泰康人寿卖保险3月、饿了么送外卖2月，还有炸鸡排、直销等第2345份工作
• ????2015.08 开始从事Java开发，闯过外包，呆过大厂！擅长抽象思维，任基础架构团队负责人
• ????2021.08 因“双减政策”失业！历经9面，终获美团外卖L8的offer
• ????????‍♀️Java架构师、Spring开源贡献者、CSDN博客之星年度Top 10、领域建模专家、写作大赛1/2届评委
• ????高质量代码、规范践行者；DDD领域驱动深度实践；即将出版书籍《Spring奇淫巧技》

序号	专栏名称	简介
01	[YourBatman]-程序人生	程序人生，人生程序
02	[YourBatman]-资讯/新特性	IDEA、JDK、Spring技术栈…新特性
03	[YourBatman]-IntelliJ IDEA	熟练使用IDEA就相当拥有物理外挂，助你高效编码
04	[YourBatman]-Bean Validation	熟练掌握数据校验，减少90%的垃圾代码
05	[YourBatman]-日期时间	帮你解决JDK Date、JSR 310日期/其实 的一切问题
06	[YourBatman]-Spring类型转换	Spring类型转换-框架设计的基石
07	[YourBatman]-Spring static	static关键字在Spring里的应用
08	[YourBatman]-Cors跨域	关于跨域请求问题，本专栏足矣
09	[YourBatman]-Jackson	Almost Maybe是最好的Jackson专栏
10	[YourBatman]-Spring配置类	专讲@Configuration配置类，你懂的
11	[YourBatman]-Spring技术栈	暂无所属小分类的，Spring技术栈大分类
12	[YourBatman]-JDK	暂无所属小分类的，JDK技术栈大分类
13	[YourBatman]-Servlet	Servlet规范、Web相关内容专题
14	[YourBatman]-Java EE	从Java EE到Jakarta EE，30年弹指一挥间
15	[YourBatman]-工具/提效	开发工具、软件工具，目标是提效
16	[YourBatman]-Spring技术栈新特性	Spring Framework、Spring Boot、Spring Cloud、Spring其它技术
17	[YourBatman]-基本功	每个Javaer，都需要有扎实的基本功
…	…	…
99	源代码库	大多数专栏均配有源代码，都在这里

• 源代码库地址：https://github.com/yourbatman/tech-column-learning
• CSDN主页：https://blog.csdn.net/f641385712
• 掘金主页：https://juejin.cn/user/430664289367192
• 博客园主页：https://www.cnblogs.com/yourbatman
• 个人博客主页：https://yourbatman.cn
• 个人网盘主页：https://wangpan.yourbatman.cn