mq

2026 年 4 月 17 日

673 字

2 分钟

其他

这是一个非常好的习惯!记录错误(Bug Summary)是提升技术深度最快的方式。

以下我为你准备了一份结构清晰、排版美观的 Markdown 笔记,你可以直接复制到你的 Obsidian、Notion 或 Typora 中。


📝 开发笔记:Spring AMQP 消息转换器(MessageConverter)踩坑记录

1. 问题描述

在使用 Spring Boot 整合 RabbitMQ 发送 Map 或自定义对象消息时,出现以下异常现象:

  • 现象 A:消费者监听到消息触发,但打印出来的消息体为空 {} 或属性为 null。
  • 现象 B:代码编译或运行时报错,提示 Jackson2JsonMessageConverter 无法转换为 MessageConverter。
  • 现象 C:RabbitMQ Web 控制台查看消息显示为乱码(JDK 序列化特征)。

2. 核心原因分析

原因一:导错包(最隐蔽)

在配置类 MessageConfig 中,自动补全代码时误导入了日志框架的类:

  • ❌ 错误导入:ch.qos.logback.classic.pattern.MessageConverter
  • ✅ 正确导入:org.springframework.amqp.support.converter.MessageConverter

原因二:生产者与消费者配置不对称

RabbitMQ 的消息转换器不是全局生效的。如果:

  1. 生产者未配置 JSON 转换器 $\rightarrow$ 发送的是 JDK 序列化二进制流(乱码)。
  2. 消费者配置了 JSON 转换器 $\rightarrow$ 尝试用 Jackson 解析二进制流。
  • 结果:解析失败,导致对象为空或属性丢失。

原因三:消费即删除机制

在 Web 控制台观察不到消息,是因为消费者处于开启状态。消息一旦进入队列,会被消费者立即取走并回复 ACK,随后 RabbitMQ 物理删除该消息。


3. 解决方案

步骤一:统一配置转换器

在 Publisher(生产者) 和 Consumer(消费者) 的项目中,都必须声明 JSON 转换器。

Java

@Configuration
public class MessageConfig {
    @Bean
    public MessageConverter messageConverter() {
        // 必须是 org.springframework.amqp.support.converter 包下的接口
        return new Jackson2JsonMessageConverter();
    }
}

步骤二:实体类规范

确保发送的对象(如 User 或 Map)满足以下条件:

  1. 必须有无参构造函数(Jackson 反序列化需要)。
  2. 必须有 Setter 方法或 Lombok 的 @Data 注解。

步骤三:调试验证技巧

如果再次遇到空消息,按以下步骤排查:

  1. 停掉消费者,发送一条消息。
  2. 在 RabbitMQ Web UI 观察 Payload。
    • 若是 {"name":"张三"} $\rightarrow$ 发送端 OK。
    • 若是乱码 $\rightarrow$ 发送端配置失效。

4. 总结与反思

  1. 导包要细心:IntelliJ 的自动导包(Alt+Enter)可能会匹配到多个同名接口,务必核对包名。
  2. 对称性原则:分布式系统中的序列化协议必须两端一致。
  3. 看懂日志:控制台打印的 {name=张三} 是 Map 的 toString 格式,而 {"name":"张三"} 才是 JSON 字符串。
mq
https://blog.yagami.top/blog/mq/
作者
Nekode
发布时间
2026 年 4 月 17 日
许可协议
CC BY-NC-SA 4.0

正在加载评论...

输入关键词开始搜索