跨语言联调:Node.js 发送的 JSON 格式 RabbitMQ 消息,Spring Boot 端接收反序列化踩坑

大宇姑娘_6971

大宇姑娘_6971

2026-05-24

760人浏览

原创

spring boot消费者用string接收node.js发来的json消息会报错,因jackson将{"..."}识别为jsontoken.start_object而非字符串字面量;正确方式是改用byte[]、message原生接收或禁用jackson介入。

跨语言联调:node.js 发送的 json 格式 rabbitmq 消息,spring boot 端接收反序列化踩坑

Spring Boot 消费者用 String 接收 Node.js 发来的 JSON 消息,十有八九会报 Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`) ——这不是 Spring Boot 的 bug,而是 Jackson 在严格执行类型契约。

为什么 String 参数在 Spring AMQP 里不等于“原样读字节”

当你声明 @RabbitListener 方法参数为 String,且项目中配置了 Jackson2JsonMessageConverter(常见于 Spring Boot 自动装配),框架就会尝试把消息体反序列化成 String 类型。但 Jackson 看到的是 {...} 开头的 JSON 对象,它只认得 "hello" 这种纯字符串字面量,遇到花括号就直接拒绝。

关键点在于:String 在这里不是“原始 payload 容器”,而是要参与 Jackson 反序列化的正式目标类型。

  • Node.js 发送的是 {"id":123,"name":"foo"}(application/json)
  • Spring Boot 启用了 Jackson2JsonMessageConverter
  • 消费者方法写的是 public void handle(String body)
  • 结果:Jackson 尝试把 JSON object 解析成 String → 失败

正确接收 JSON 字符串的三种实操方式

目标是让 Spring Boot 把整段 JSON 当作原始字符串拿过来,跳过 Jackson 的结构解析。

Browser Js
Browser Js

轻量级CDP浏览器控制,适用于AI代理。相较于内置浏览器工具,token消耗降低3‑10倍,仅在浏览时使用。

下载
  • 把参数类型换成 byte[]:Spring AMQP 对 byte[] 有特殊处理逻辑,不会走 Jackson,直接返回原始字节,再用 new String(bytes, StandardCharsets.UTF_8) 转换
  • 用 org.springframework.amqp.core.Message 原生接收:调用 message.getBody() 拿到 byte[],同样可转字符串,还能访问 message.getMessageProperties().getContentType() 做校验
  • 禁用 Jackson 对该方法的介入:在方法上加 @Payload(required = false) 并配合 Message,或干脆不加 @Payload,让 Spring 绕过 converter 直接注入原始 Message 实例

如果必须用对象接收,类型声明必须匹配 JSON 结构

Node.js 发的是 {"userId":1001,"action":"login"},那 Spring Boot 就不能用 String,也不能用 Map(除非你确定字段名和类型完全可控)。

  • 推荐定义一个轻量 DTO,比如 LoginEvent,字段名、类型、getter/setter 齐全
  • 确保 Node.js 和 Java 的字段命名策略一致(如都用 camelCase,或统一配 Jackson 的 @JsonProperty)
  • 避免用 Map<string object></string>:它对嵌套结构、数字类型推导不稳定,容易在深层字段上反序列化失败
  • 若字段动态多变,可用 com.fasterxml.jackson.databind.JsonNode:它是 Jackson 的通用 JSON 树模型,能安全承载任意结构

跨语言场景下最容易被忽略的 contentType 和编码

Node.js 发送时没设 contentType,或设成了 text/plain,而 Spring Boot 的 Jackson2JsonMessageConverter 默认只处理 application/json。这时即使 JSON 内容合法,converter 也可能被跳过,降级到 SimpleMessageConverter,导致反序列化路径错乱。

  • Node.js 端务必显式设置 contentType: 'application/json'(RabbitMQ message properties)
  • Spring Boot 端检查是否启用了全局 Jackson2JsonMessageConverter bean,而不是依赖自动配置的模糊匹配
  • UTF-8 编码必须两端一致;Node.js 用 Buffer.from(jsonStr, 'utf8') 发,Java 端别用系统默认编码解
  • 测试时用 curl -X POST ... --data-binary @msg.json 手动发一条原始消息,验证 broker 中存的内容是否符合预期

真正麻烦的不是怎么写代码,而是两端对“JSON 消息”这件事的理解偏差:Node.js 认为发的是字符串,Spring Boot 却把它当结构体来验。跨语言联调里,契约比实现更早失效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js node.js json node rabbitmq

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2491

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

rabbitmq和kafka有什么区别
rabbitmq和kafka有什么区别

rabbitmq和kafka的区别:1、语言与平台;2、消息传递模型;3、可靠性;4、性能与吞吐量;5、集群与负载均衡;6、消费模型;7、用途与场景;8、社区与生态系统;9、监控与管理;10、其他特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

584

5

Java 消息队列与异步架构实战
Java 消息队列与异步架构实战

本专题系统讲解 Java 在消息队列与异步系统架构中的核心应用,涵盖消息队列基本原理、Kafka 与 RabbitMQ 的使用场景对比、生产者与消费者模型、消息可靠性与顺序性保障、重复消费与幂等处理,以及在高并发系统中的异步解耦设计。通过实战案例,帮助学习者掌握 使用 Java 构建高吞吐、高可靠异步消息系统的完整思路。

2026.01.28

888

20

RabbitMQ使用教程合集
RabbitMQ使用教程合集

RabbitMQ使用教程合集整理 RabbitMQ 基础教程、消息队列开发案例、生产者消费者、交换机与队列实战内容。

2026.05.20

184

15

RabbitMQ集群部署指南
RabbitMQ集群部署指南

RabbitMQ集群部署指南聚合 RabbitMQ 集群部署、高可用架构、镜像队列、故障恢复、监控与运维优化内容。

2026.05.20

137

12

RabbitMQ Docker实战指南
RabbitMQ Docker实战指南

RabbitMQ Docker实战指南提供 RabbitMQ Docker 镜像部署、Docker Compose、Kubernetes Operator 与云原生实践教程。

2026.05.20

142

10

node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

2023.09.19

10309

8

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

2025.11.26

434

14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.9万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.8万人学习