Spring Cloud Stream 3.x 整合 RabbitMQ 抛弃旧版注解后怎么编写发送代码?

落静吖_2792

落静吖_2792

2026-05-26

809人浏览

原创

Spring Cloud Stream 3.x弃用@Input/@Output和Source等接口,唯一推荐发送方式是注入StreamBridge;其参数需匹配配置中binding名(如my-out-0),而非exchange名或routingKey,且须配置content-type和正确依赖以支持自动序列化。

发送消息必须用 StreamBridge,别再写 @Output 和 Source

spring cloud stream 3.x 彻底移除了 @input/@output 注解和基于接口的绑定方式,source、sink、processor 这些预定义接口也废弃了。现在唯一推荐的发送方式是注入 streambridge 实例,它支持动态 destination 和运行时参数化。

常见错误:还在配置 @EnableBinding(Source.class) 或手动 new MessageChannel,会直接启动失败或抛 IllegalStateException: No binding targets defined。

  • StreamBridge 是线程安全的,可全局单例复用,无需每次 new
  • destination 名称要和 spring.cloud.stream.bindings.<name>.destination</name> 配置项一致(不是 exchange 名,而是逻辑 binding 名)
  • 不支持在 @PostConstruct 中提前调用 send(),因为 binding 初始化可能尚未完成;建议放在业务方法中触发

destination 名怎么配?不是 exchange 名,也不是 routingKey

你传给 streamBridge.send("my-out-0", message) 的字符串 "my-out-0",必须对应配置文件中声明的 binding 名,例如:

spring:
  cloud:
    stream:
      bindings:
        my-out-0:
          destination: orders.exchange
          binder: rabbit
          content-type: application/json

这里 my-out-0 是 binding 名(任意合法 ID),orders.exchange 才是 RabbitMQ 的 exchange 名。如果写反了——比如把 orders.exchange 直接当参数传给 send()——会报 No binding found for 'orders.exchange'。

  • RabbitMQ binder 默认将 destination 映射为 exchange,若需指定 routingKey,得用 spring.cloud.stream.rabbit.bindings.<name>.producer.routing-key-expression</name>
  • 如果没配 destination,只写了 my-out-0 绑定但没设值,StreamBridge 会尝试创建一个默认 exchange,名字是 my-out-0,但通常不符合预期
  • 多个 destination 共享同一个 exchange?可以,只要各自 binding 的 destination 值相同即可

发 JSON 消息要手动序列化?不,靠 content-type 和 MessageBuilder

别再用 ObjectMapper.writeValueAsBytes() 手动转 JSON 再封装 Message。正确做法是让 binder 自动处理序列化,前提是:

Upload audio to AIOZ Stream
Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象,上传文件并完成处理后返回音频链接。

下载
  • 配置里明确声明 content-type: application/json(否则默认是 text/plain,对象会被 toString())
  • 用 MessageBuilder.withPayload(obj).build() 构造消息,payload 是 POJO,不要提前转成 String 或 byte[]
  • 确保 POJO 有 public getter、无参构造器,且类路径下有 Jackson 依赖(spring-boot-starter-json)

如果 payload 是 String 类型,又没设 content-type,binder 会把它当纯文本发出去,RabbitMQ 里看到的是带引号的字符串,而不是解析后的 JSON 对象。

测试时收不到消息?先检查 binder 是否真正启用了

本地跑不通最常见原因是 RabbitMQ binder 没加载成功,表现为 StreamBridge.send() 不报错但消息根本没进 RabbitMQ。典型原因:

  • 漏加依赖:spring-cloud-starter-stream-rabbit(不是 spring-boot-starter-amqp)
  • 配置里写了 binder: rabbit,但没配 spring.rabbitmq.* 基础连接参数,导致 binder 初始化失败后静默跳过
  • 使用了 test-binder(如 spring-cloud-stream-test-binder),它会拦截所有 send 调用,消息根本不落地

验证方法:启动日志搜 Creating binder 和 RabbitServiceAutoConfiguration,没看到说明 binder 没生效;或者用 rabbitmqctl list_exchanges 看目标 exchange 是否被自动创建出来。

binding 名和配置项名称对不上、content-type 没显式声明、binder 未实际加载——这三个点最容易卡住人,而且错误表现都很“安静”。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3009

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2268

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1200

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1158

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1336

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2098

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3320

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

14915

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CentOS 官方文档
CentOS 官方文档

共0课时 | 0人学习

极客学院Java8新特性视频教程
极客学院Java8新特性视频教程

共17课时 | 4.3万人学习

RabbitMQ 入门教程
RabbitMQ 入门教程

共0课时 | 134人学习