Spring Boot 4 和 Spring Framework 7:Java 微服务快速安全的新时代
我自己有个小服务,跑 Spring Boot 3 两年了。没什么光鲜的:一个从两家供应商拉数据、存进 Postgres、返回 JSON 的 API。就是那种你会在某个不知名的周日下午坐下来维护的无聊服务。
11 月 13 日 Spring Framework 7.0 发布。20 日 Spring Boot 4.0 发布。21 日周五,早咖啡还没凉,我开了一条迁移分支。
不是因为服务急着要升。我想诚实回答一个问题:这一版里有多少是真变化,有多少只是 release notes 的目录?两天下来,我手里的东西如下。
OpenRewrite 修好了什么,什么留给了我
最先跑的是社区配方 org.openrewrite.java.spring.boot4.UpgradeSpringBoot_4_0。"社区"这点值得强调:Spring 团队并不维护它,边角上看得出来。
一个下午,它就让 build 重新编译通过了。升了依赖,把我挪到 Jackson 3(现在是默认,Jackson 2 作为弃用的过渡桥,会自己关掉:7.1 里自动检测停用,7.2 里彻底消失),还重命名了一批 yaml 属性。
没修好的部分才是有意思的部分。Undertow 不再支持,如果你的容器是 Undertow,得搬到 Tomcat 或 Jetty。starter 做了模块化,spring-boot-starter-web 现在以 spring-boot-starter-webmvc 的身份应答;我这里只是改个名,但有自定义 starter 的项目就得坐下来逐个过一遍。还有 TestRestTemplate 单独拆出去了:需要它自己的测试依赖,不过新代码可以用 RestTestClient,顺手连类型都更靠谱。
编译绿不等于跑起来也绿。这部分仍然是我的活。
凌晨三点的 NPE
前阵子一家供应商没打招呼就改了 API,一个在开发环境从来没空过的字段,到了生产环境开始返回 null。服务凌晨三点挂了。告警把我叫醒。从那以后,任何不声明自己 null 语义的 API 我都不信。
所以在 Framework 7 带来的所有东西里,我最在意的是 JSpecify:一个由 Google、JetBrains 等几家公司一起攒的标准,Spring 在整个产品线里采纳了。IntelliJ 和 Eclipse 都已经认识它。在自己代码里落地最便宜的方式是一个 package-info.java:
// src/main/java/com/zademy/service/package-info.java
@org.jspecify.annotations.NullMarked
package com.zademy.service;这样一来,整个包默认非空。可能缺席的东西标 @Nullable,IDE 在你敲代码的时候就提醒你,而不是等它在生产上炸了、寻呼机响个不停的时候。那天凌晨要是有这个,代价会小很多。光这一个变化,迁移的一半就值回来了。
声明式 HTTP 客户端
Framework 7 的参考文档已经把 RestTemplate 标记为弃用。@Deprecated 注解要到 7.1 才来。也就是说,今天不会炸,但路已经写好了,值得开始走。
对我来说,自然的替代品是 @HttpExchange 的声明式客户端。以前这需要 OpenFeign 和它的一堆依赖;现在它就长在框架里:
@HttpExchange("/api/products")
public interface ProductClient {
@GetExchange("/{id}")
Product getProduct(@PathVariable("id") String id);
@GetExchange
List<Product> listProducts();
@PostExchange
Product createProduct(@RequestBody Product product);
}你定义的是调用什么,不是怎么调用。测试里随便模拟,因为它就是个接口。哪天需要响应式变体,@ImportHttpServices 里的 clientType 在 RestClient 和 WebClient 之间切换,接口一行不用动。
早就在的和真新的
怀疑论的一面来了。好几个被当作版本 4 新东西庆祝的,其实不新。JdbcClient 用起来很舒服,但 Framework 6.1 就有了。@Observed 在 Boot 3 里就在了。Micrometer 现在是 1.16 加 Tracing 1.6,不是我在别处反复读到的一个想象中的 2.0;那边真正新的,是官方的 OpenTelemetry starter。
真新的东西:原生弹性进了 spring-context,@Retryable、@ConcurrencyLimit、@EnableResilientMethods,不需要外部依赖;还有 API 版本控制终于声明式了,@RequestMapping 上有了 version 属性,spring.mvc.apiversion.* 负责选策略。这两个都在我的分支里赢得了位置。
要求方面:Java 17 起步,支持到 Java 25(推荐的 LTS),Kotlin 2.2,GraalVM 25,Jakarta EE 11 全量,含 Servlet 6.1、JPA 3.2、Bean Validation 3.1。性能方面,官方承诺启动更快,功劳记在拆成模块的自动配置上。我没跑自己的 benchmark,别人家的我看腻了,所以这笔账先记着:在真服务上测完之前,这句话我不替他们重复。
证书的未遂事故
另一个刻在我脑子里的惊吓,是一家供应商的证书在某个周六到期了。我知道这事是因为有个用户写信来,不是因为有东西报警。
分支上我把 Actuator 的证书检查配上了:哪个证书快到期,health 端点会在它变成事故之前报出来。我不是为了这个才迁移的,但这几天配置的东西里,把安心感还给我的最多的是它。一次未遂事故教的东西比一个 changelog 多。
目前的结论
新项目:上,不用犹豫。在往后几年的地基上起步是合理的,.0 的毛刺会被慢慢磨平。这篇笔记写在 GA 后没几天,我故意不引用补丁号:等你读到的时候,4.0.x 早往前走了。
活着的项目:别惯性迁移。等一个真实的触发点,比如需要 Jackson 3、需要版本化 API、或者想甩掉弹性方面的外部依赖。这些都不紧迫的话,Boot 3 不会明天就倒。
我的分支走到一半:能编译,大部分测试通过,剩下集成测试,以及对着发布说明把属性变更一条条过一遍。这不是一个下午的事,谁说反过来谁就没做过。但从那条分支里出来的服务会更好维护。目前,这对我够了。