Spring Boot 开发中 RabbitMQ 的 “SimpleMessageConverter” 默认安全隐患及替换方案

老雪姑娘_8404

老雪姑娘_8404

2026-05-25

866人浏览

原创

simplemessageconverter 默认不安全,因依赖 jdk 原生序列化,存在反序列化任意类风险(如 cve-2023-34050),且无法跨语言/版本兼容;它仅适用于 amqp 基础类型,传 pojo 会触发危险序列化,生产环境必须替换为 jackson2jsonmessageconverter 或显式加固。

spring boot 开发中 rabbitmq 的 “simplemessageconverter” 默认安全隐患及替换方案

SimpleMessageConverter 默认不安全,生产环境必须替换或显式加固。它依赖 JDK 原生序列化,既无法跨语言/跨版本兼容,又会在反序列化时无条件加载任意类——CVE-2023-34050 就源于此。Spring Boot 2.2+ 已默认禁用未白名单类的反序列化,但只要没配 allowed-classes 或换掉转换器,SimpleMessageConverter 仍会尝试反序列化,直接抛 ClassNotFoundException 或触发安全拦截。

为什么 SimpleMessageConverter 在 Spring Boot 中默认“危险”

它不是设计来传业务对象的,而是为 AMQP 协议层基础类型(byte[]、String)服务的。一旦你往 RabbitTemplate.convertAndSend() 里传一个自定义 POJO,它就会调用 SerializationUtils.serialize(),把类名、字段值、甚至类字节码一起打成二进制塞进 Message.body。消费者端一收到,就按 MessageProperties.contentType = "application/x-java-serialized-object" 去反序列化——前提是本地 classpath 里得有那个类;否则报 ClassNotFoundException;更糟的是,如果攻击者能控制消息内容,还能注入恶意类执行任意代码。

常见错误现象:

  • 消费者启动时报 java.lang.ClassNotFoundException: com.example.order.OrderDTO,即使你确认 jar 包里有这个类
  • 测试环境正常,上线后突然消费失败,日志只显示 Failed to convert message 没有堆栈
  • 启用 spring.rabbitmq.listener.simple.default-requeue-rejected=false 后消息直接进死信队列,查不到具体原因

用 Jackson2JsonMessageConverter 替换的实操要点

这是最常用、最稳妥的替换方案,本质是把对象转成 JSON 字符串再发,彻底绕开 Java 序列化链路。但要注意几个关键点:

  • 必须在 Spring 容器中声明一个 Jackson2JsonMessageConverter 类型的 @Bean,Spring Boot 的自动配置(RabbitAutoConfiguration)才会把它同时注入到 RabbitTemplate 和 SimpleRabbitListenerContainerFactory
  • 发送端和消费端必须用同一个 MessageConverter,否则消费端用 SimpleMessageConverter 去解 JSON body,会直接报 Cannot construct instance of java.util.LinkedHashMap 类型错误
  • 如果 DTO 里有 LocalDateTime 等非标准类型,需提前注册 JavaTimeModule,否则序列化失败

示例配置:

RabbitMQ 4.2.3
RabbitMQ 4.2.3

RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本,重点修复了 Khepri 元数据存储相关问题,并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说,该版本兼容性和稳定性表现较好。

下载
@Bean
public MessageConverter jackson2JsonMessageConverter() {
    Jackson2JsonMessageConverter converter = new Jackson2JsonMessageConverter();
    ObjectMapper objectMapper = new ObjectMapper();
    objectMapper.registerModule(new JavaTimeModule());
    converter.setJsonObjectMapper(objectMapper);
    return converter;
}

不换转换器,只加固 SimpleMessageConverter 的风险与限制

理论上可以保留 SimpleMessageConverter,仅通过配置白名单收紧反序列化范围,比如:

  • 设置 spring.rabbitmq.listener.simple.allowed-classes=com.example.** —— 但该配置只对 Jackson2JsonMessageConverter + @type 多态反序列化生效,对 SimpleMessageConverter 无效
  • 想让 SimpleMessageConverter 安全,只能自己继承它并重写 fromMessage(),在反序列化前校验 ObjectInputStream 的类名,但这已脱离 Spring AMQP 标准路径,维护成本高且容易漏掉边界 case
  • Spring 团队已在文档中明确建议:“Avoid using SimpleMessageConverter for custom domain objects”

换句话说:加固 SimpleMessageConverter 是条死胡同,不是配置问题,是机制缺陷。

最容易被忽略的兼容性陷阱

团队协作中,有人用 Jackson2JsonMessageConverter 发消息,有人还用默认 SimpleMessageConverter 消费,结果消息体是 JSON 字符串,却被当成二进制流去反序列化,报错信息极其隐晦,比如:

  • InvalidClassException: invalid descriptor for field
  • StreamCorruptedException: invalid type code: 7B(0x7B 是 { 的 ASCII,说明 body 实际是 JSON)

这类问题不会在编译期暴露,只有运行时发消息才触发,且上下游日志对不上。真正要落地,必须统一团队的转换器声明方式,并在 CI 阶段检查 MessageConverter Bean 是否唯一存在。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10717

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7842

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6832

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1164

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

948

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1396

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2829

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20111

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1255

8

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 入门教程
RabbitMQ 入门教程

共0课时 | 137人学习

RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

RabbitMQ 官方文档
RabbitMQ 官方文档

共0课时 | 0人学习