本文介绍如何在不修改原始类的前提下，通过Jackson混入（Mixin）机制解决因继承导致的UnrecognizedPropertyException问题，核心是启用基于字段推断的多态类型识别。
本文介绍如何在不修改原始类的前提下，通过jackson混入（mixin）机制解决因继承导致的`unrecognizedpropertyexception`问题，核心是启用基于字段推断的多态类型识别。
当使用Jackson将JSON反序列化为Java对象时，若Base类中parent字段声明为父类Parent，但实际JSON包含子类Child特有字段（如"field"），Jackson默认无法推断运行时类型，从而抛出 UnrecognizedPropertyException：字段"field"不被Parent类识别。
根本原因在于Jackson默认采用静态类型绑定——它仅依据Base.parent的声明类型（Parent.class）进行反序列化，忽略JSON中实际存在的子类字段。要支持多态反序列化，必须显式告知Jackson：该字段可能对应多个子类型，并提供类型识别策略。
推荐方案：使用Mixin + @JsonTypeInfo(Id.DEDUCTION)（无需侵入原类）
Jackson 3.0+ 支持基于字段名自动推断子类型的DEDUCTION策略，它会扫描JSON对象中的字段集合，并与各候选子类的可读字段（getter）比对，匹配度最高者即为目标类型。此方式简洁、类型安全，且完全避免在业务类上添加注解。
实现步骤如下：
-
定义抽象Mixin类（仅用于配置，无逻辑）
public abstract class ParentMixin {} -
为Mixin类添加Jackson元数据（使用@JsonTypeInfo和@JsonSubTypes）
@JsonTypeInfo( use = JsonTypeInfo.Id.DEDUCTION, defaultImpl = Parent.class // 可选：指定无匹配时的兜底类型 ) @JsonSubTypes({ @JsonSubTypes.Type(Child.class) }) public abstract class ParentMixin {} -
注册Mixin到ObjectMapper（反序列化时使用）
ObjectMapper mapper = new ObjectMapper(); mapper.addMixIn(Parent.class, ParentMixin.class); // 将Mixin规则绑定到Parent类
-
完整修复后的反序列化代码示例
// 序列化（保持不变） ObjectMapper writeMapper = new ObjectMapper(); writeMapper.writeValue(new File("C:\temp\c.json"), b); // 反序列化（关键：启用Mixin） ObjectMapper readMapper = new ObjectMapper(); readMapper.addMixIn(Parent.class, ParentMixin.class); Base baseResult = readMapper.readValue( new FileInputStream("C:\temp\c.json"), Base.class ); // 此时 baseResult.getParent() 将正确返回 Child 实例，field值可正常访问
✅ 优势说明
- ✅ 零侵入：原始Parent/Child类无需任何Jackson注解；
- ✅ 类型安全：DEDUCTION策略依赖字段签名，比PROPERTY（需额外type字段）更简洁；
- ✅ 可扩展：新增子类只需在@JsonSubTypes中追加@Type(AnotherChild.class)即可。
⚠️ 注意事项
- DEDUCTION要求子类字段集具有足够区分度（例如Child含field而其他子类不含），否则可能推断失败；
- 若存在字段重叠严重的子类，建议改用@JsonTypeInfo(use = Id.NAME, include = As.PROPERTY)并显式写入"@type":"child"；
- Mixin必须在反序列化专用的ObjectMapper实例上注册，序列化无需此配置（因对象类型在运行时已明确）。
通过Mixin机制，你既保持了领域模型的纯净性，又赋予了Jackson智能识别多态类型的能力——这是构建可维护、可扩展JSON API的关键实践。
