Apache Camel中Jackson反序列化器报错、手动解析正常问题排查
业务场景说明
正在使用Apache Camel整合Jackson完成JSON字符串的反序列化处理流程。
- 待解析的JSON报文内容:
{"GUID":"123"}
- Camel路由中配置的反序列化链路:
... .unmarshal().json(JsonLibrary.Jackson, TestPojo.class)
- 定义的对应POJO结构(原代码写法):
TestPojo { @JsonProperty("GUID") private String guid; @JsonProperty("GUID") public String getGuid(){ return guid; } @JsonProperty("GUID") public String setGuid(){ return guid; } }
- 执行时抛出的异常信息:
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "GUID" (class package.TestPojo), not marked as ignorable (1 known properties: "guid")
- 已验证可正常运行的替代实现:在路由中插入Processor,手动实例化ObjectMapper完成解析,流程可正常跑通,对应代码:
.process(e -> { ObjectMapper mapper = new ObjectMapper(); e.getIn().setBody(mapper.readValue(e.getIn().getBody(String.class),TestPojo.class)); })
问题根因
- POJO类存在多处基础写法错误:
- 类定义缺少
public访问修饰符 - 字段上的
@JsonProperty注解字符串缺少右闭合引号,会导致注解解析异常 setGuid方法违反JavaBean规范,被定义为String返回值、无入参,既无法完成字段赋值,也不会被Jackson识别为标准的setter方法
- 类定义缺少
- 序列化配置不一致:Camel内置Jackson反序列化环节使用的ObjectMapper实例,和手动测试时
new出来的独立ObjectMapper实例并非同一个对象。Camel的Jackson组件默认会复用容器内注册的全局ObjectMapper实例,该实例的配置往往和独立实例存在差异,最常见的差异是全局实例关闭了Jackson的注解识别开关,导致@JsonProperty标注不生效,最终识别到的属性只有POJO的Java字段名guid,无法匹配JSON里的GUID字段,触发UnrecognizedPropertyException异常。 - 常见配置错位场景:
- 编写路由时未显式关联可正常工作的ObjectMapper实例,直接使用组件默认的序列化配置
- 容器内注册的全局ObjectMapper Bean通过配置关闭了注解识别、修改了全局命名策略,导致注解标注的字段映射关系失效
修正方向
- 调整POJO类的基础写法:补充
public类修饰符、补全注解的闭合引号、将setGuid调整为void返回值、接收String类型入参,在方法内完成guid字段的赋值逻辑 - 统一序列化配置:将手动测试通过的ObjectMapper实例,显式绑定到Camel的Jackson数据格式组件上,确保反序列化环节的配置和手动测试场景完全一致,不依赖组件默认的全局配置
内容的提问来源于stack exchange,提问作者Anatoly Utkin
相关产品推荐
相关产品推荐

