ZealSinger头像
Boot4升后Streams定制器怎么换封面图

Boot4升后Streams定制器怎么换

升到 Spring Boot 4 之后,原先实现或注入 StreamsBuilderFactoryBeanCustomizer 的代码会直接编译失败:这个类型已经删除,不是换个包名再 import 就能过。这不是「Kafka Streams 不能用了」。本稿只讲:旧定制器类型没了怎么换、默认 order 是多少、怎么验。

同系列可对照:映射空值怎么改 always、静态资源 fonts 怎么排除、uber 包可选依赖怎么打进、EntityScan 包名怎么迁、Kafka retry 属性怎么改——一句带过,不写进本稿主线。升 4 后如果只看到「找不到 Customizer」,先确认是不是这篇的 Streams 工厂定制器,再决定要不要改类型,避免和别的 Customizer 升级项搜到一起。

痛点:升 Boot4 后,旧 Streams 定制器为什么找不到?

现场常见三类现象:

  1. 编译失败——仓库里还在实现 StreamsBuilderFactoryBeanCustomizer,或还在往容器里注入这个类型,升 Boot 4 后类型不存在。
  2. 定制逻辑不再生效——以为换一下 import 就能过,结果新包路径下根本没有这个接口,定制代码没有挂到 StreamsBuilderFactoryBean 上。
  3. order 和升前对不上——迁到新接口之后,定制器不再像旧类型那样相当于最低优先级,默认 order 变成了 0,和框架里其它 configurer 的先后关系需要重新看。

目标很具体:按 Migration Guide 的 Kafka Streams Customization 段,把定制逻辑迁到 Spring Kafka 的 StreamsBuilderFactoryBeanConfigurer#configure,弄清默认 order 是 0,并在 Boot / Spring Kafka 路径下按 Ordered 验收全部 configurer。

升版扫仓库时,先按完整旧类名 org.springframework.boot.autoconfigure.kafka.StreamsBuilderFactoryBeanCustomizer 搜,不要只搜 Guide 里少一个 s 的错名。每处实现改成新接口后,再核对这个 bean 要不要显式 getOrder():升前靠后执行的,默认 0 往往不够靠后。

图注:旧类型 StreamsBuilderFactoryBeanCustomizer#customize 已删除,不是换包;改用 StreamsBuilderFactoryBeanConfigurer#configure;接口实现 Ordered,默认 0;Boot / Spring Kafka 按序应用全部 configurer。

规则:Guide 原文怎么说?类型名不要抄错

口径以 Spring Boot 4.0 Migration Guide · Kafka Streams Customization 为准(Andy Wilkinson 编辑于 Jun 28, 2026;核对日 2026-11-14 Asia/Shanghai):

Spring Boot’s StreamBuilderFactoryBeanCustomizer has been removed in favor of Spring Kafka’s StreamsBuilderFactoryBeanConfigurer. When migrating to the new configurer, be aware that it implements Ordered with a default value of 0.

Guide 这段把旧类型写成了 StreamBuilderFactoryBeanCustomizer(少一个 s)。不要照抄这笔笔误。 真实旧类型是 StreamsBuilderFactoryBeanCustomizer,完整包名见下表。正文、搜索替换和代码都用带 s 的全名。

项口径
旧类型(已删除)org.springframework.boot.autoconfigure.kafka.StreamsBuilderFactoryBeanCustomizer
旧方法void customize(StreamsBuilderFactoryBean factoryBean)
旧类型与 Ordered不实现 Ordered,效果相当于最低优先级
不是换包Boot 4 新包 org.springframework.boot.kafka.autoconfigure 下也没有这个类型;编译失败是「类型不存在」
新类型org.springframework.kafka.config.StreamsBuilderFactoryBeanConfigurer(Spring Kafka,自 2.6.7)
新方法void configure(StreamsBuilderFactoryBean factoryBean)
默认 order接口 default int getOrder() { return 0; },Javadoc 写明 Default order is 0
调用时机按顺序应用到框架配置的那一个 StreamsBuilderFactoryBean;在 bean 创建之后、启动之前调用
多个 configurerBoot / Spring Kafka 默认工厂按 Ordered 全部应用,不是只取一个

Boot 4.0.0 参考文档也写了:可以注册任意多个实现 StreamsBuilderFactoryBeanConfigurer 的 bean,做更高级的定制。Spring Kafka 4.0.0 的默认工厂实现是按 orderedStream() 逐个调用 configure。

不要把这条变化写成「Kafka Streams 不能用了」,也不要和已发的 Kafka retry 属性迁移并线。

怎么改:换成 Configurer,必要时显式写 order

1. 把 customize 换成 configure

旧代码实现的是 org.springframework.boot.autoconfigure.kafka.StreamsBuilderFactoryBeanCustomizer#customize。升 4 后这个类型已经删除,搜索旧类名,把实现改到新接口上,方法名从 customize 改成 configure,包名改成 org.springframework.kafka.config。

package com.example.streams;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.kafka.config.StreamsBuilderFactoryBean;
import org.springframework.kafka.config.StreamsBuilderFactoryBeanConfigurer;

@Configuration
public class DefaultOrderStreamsConfig {
    @Bean
    public StreamsBuilderFactoryBeanConfigurer defaultOrderStreamsConfigurer() {
        return new StreamsBuilderFactoryBeanConfigurer() {
            @Override
            public void configure(StreamsBuilderFactoryBean factoryBean) {
                factoryBean.setAutoStartup(false);
            }
        };
    }
}

上面这种写法走接口默认 getOrder(),也就是 0。新接口是 @FunctionalInterface,只做一件事、并且接受默认 0 时,也可以写成 lambda 注册。但 lambda 没法方便地改 order,需要自定义先后时,仍要用类或匿名实现写出 getOrder()。

Boot 自己还会注册一个写入 autoStartup 与 cleanup 的属性 configurer,order 是 Ordered.HIGHEST_PRECEDENCE,会在用户这个默认 0 的 bean 之前执行。所以用户侧再调 setAutoStartup,可以覆盖属性项先写入的值;这是顺序带来的结果,不是属性项被丢弃。

2. 若依赖「靠后执行」,显式 getOrder()

旧 Customizer 不实现 Ordered,相当于最低优先级。新接口默认却是 0。如果升前依赖「等框架都配完再改工厂」,迁过去之后要用显式 getOrder(),不要默认成 0 就结束。

package com.example.streams;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.kafka.config.StreamsBuilderFactoryBean;
import org.springframework.kafka.config.StreamsBuilderFactoryBeanConfigurer;

@Configuration
public class LateStreamsConfig {
    @Bean
    public StreamsBuilderFactoryBeanConfigurer lateStreamsConfigurer() {
        return new StreamsBuilderFactoryBeanConfigurer() {
            @Override
            public void configure(StreamsBuilderFactoryBean factoryBean) {
                factoryBean.setAutoStartup(false);
            }

            @Override
            public int getOrder() {
                return Ordered.LOWEST_PRECEDENCE;
            }
        };
    }
}

如果还存在 MeterRegistry,Boot 会再注册一个 metrics configurer,同样使用接口默认 order 0,给工厂加上 KafkaStreamsMicrometerListener。用户 lambda 若也保持默认 0,和这个 metrics 项的相对顺序不要写死;需要稳定先后时,给自己的 bean 显式返回一个不同的 getOrder()。

3. 不要把「多个 bean 被静默丢弃」写成 Boot 的行为

在纯 Boot + Spring Kafka 路径下,官方支持任意多个 configurer,并按 Ordered 全部应用。不要把「静默丢弃」写成 Boot 通用结论,也不要为此去推荐一个未核过的 @Primary 聚合写法当官方作法。

如果项目还用了 Spring Cloud Stream 的 Kafka Streams 绑定器,旧绑定器版本里曾经出现过 getIfUnique():多个 configurer(例如 Boot 的 metrics 项加上用户定制)会双方都被静默忽略。5.0.2 的官方文档已经改成:绑定器会在工厂启动前按序调用全部 StreamsBuilderFactoryBeanConfigurer。未核对现场 Cloud Stream 小版本之前,不要把静默丢弃写成当前必然现象,也不要把某次未合并的修复 PR 当成已经落地。

4. 别和别的升级项搅在一起

这是 Kafka Streams 工厂定制器的类型替换,不是已发的 Kafka retry 属性怎么迁。搜旧类名时带上完整包名 org.springframework.boot.autoconfigure.kafka,避免和别的 *Customizer 一起误删。Guide 少写一个 s 的那次笔误不要进代码,也不要进提交说明。

怎么验

图注:旧 StreamsBuilderFactoryBeanCustomizer 在 Boot 4 编译失败;新 Configurer#configure 被应用到默认 StreamsBuilderFactoryBean;多个 configurer 在 Boot / Spring Kafka 路径按 Ordered 全部生效;同为 0 的相对顺序不要写死。

验收清单:

  1. 对照 Migration Guide 该段,但类型名以源码 / Javadoc 为准:旧类型是 StreamsBuilderFactoryBeanCustomizer,新类型是 StreamsBuilderFactoryBeanConfigurer。
  2. 确认旧类型在 Boot 4 编译期已不可用,且新包路径下也没有同名接口可换 import。
  3. 新 bean 被应用到框架配置的 StreamsBuilderFactoryBean(默认工厂在 bean 创建之后、启动之前调用 configure)。
  4. 多个 configurer 在 Boot / Spring Kafka 路径下按 getOrder() 全部生效:属性项是 HIGHEST_PRECEDENCE,用户默认 0 的项在它之后;与 metrics 项同为 0 时不要写死先后。
  5. 需要靠后执行时,显式 getOrder(),再断言定制逻辑确实发生在属性项之后。
  6. 若现场还接了 Cloud Stream 绑定器,先核对所用小版本的文档口径,再决定要不要为「多个 bean」单独验收;未核版本不要把静默忽略写成必现。

验收时建议在 configure 里打一条带 getOrder() 和 bean 名称的日志,启动一次看调用顺序,比只看能不能编译更接近真实回归。日志时间戳不要用来推断同序 bean 的稳定先后,同为 0 的两项顺序本就不该写死。

容易写错的两点

第一,不要照抄 Guide 里少一个 s 的 StreamBuilderFactoryBeanCustomizer。搜这个错名会漏掉仓库里真正的旧接口,提交说明里写成错名也会让后续排查对不上 Javadoc。正确旧名是 StreamsBuilderFactoryBeanCustomizer,新名是 StreamsBuilderFactoryBeanConfigurer,方法从 customize 换成 configure。

第二,不要把新默认 order 0 理解成「和升前一样靠后」。旧类型相当于最低优先级,新接口默认却是 0,和 metrics configurer 还可能同序。升 4 后若出现「定制偶发不生效」或「和指标监听器谁先谁后不稳定」,先看有没有显式 getOrder()。

升版 MR 描述模板(可复制)

  • 背景:Boot 4 删除了 org.springframework.boot.autoconfigure.kafka.StreamsBuilderFactoryBeanCustomizer,改用 Spring Kafka 的 StreamsBuilderFactoryBeanConfigurer,默认 order 为 0。
  • 改动:将 customize 迁到 configure;需要靠后执行的 bean 显式 getOrder()。
  • 验证:旧类型不可编译;新 configurer 应用到默认 StreamsBuilderFactoryBean;Boot / Spring Kafka 路径下多个 bean 按 Ordered 全部生效。
  • 非目标:不改 Kafka retry 属性、不改 PropertyMapper .always()。
  • 注意:Guide 旧类型名少一个 s,搜索和提交说明都以 StreamsBuilderFactoryBeanCustomizer 为准。

小结

Boot 4 把 Kafka Streams 工厂的定制口从已经删除的 StreamsBuilderFactoryBeanCustomizer 换成了 Spring Kafka 的 StreamsBuilderFactoryBeanConfigurer。改法收敛——方法改名为 configure,包名改到 org.springframework.kafka.config,记住默认 order 是 0,需要靠后就显式写。Boot / Spring Kafka 会按序应用全部 configurer,不要把「静默丢弃」写成这条路径的默认行为,也别把 Guide 少写一个 s 的类名抄进代码。迁完后把旧 import 和旧方法名一并删干净,避免仓库里同时留下 customize 和 configure 两套看起来都能编译、实际只有一套还在生效的残段。定制逻辑只应出现在新接口的 configure 里,启动一次确认工厂上的设置已经按预期落地即可。

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/Amax3747/article/details/170767587

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--