如何解决 Jackson 无法识别父类字段的反序列化问题

Lombok 的 @Jacksonized 注解会干扰 Jackson 对继承结构中父类字段的识别，导致反序列化时抛出 UnrecognizedPropertyException；移除该注解或配合显式配置可恢复对 @JsonProperty 和继承字段的正确支持。

在 Jackson 与 Lombok 搭配使用的场景中，一旦涉及继承关系（比如 Parent 父类、Child 子类），一个非常隐蔽的坑就会冒出来——子类反序列化时突然报错，提示“父类字段（如 recipient）未被识别”。不少人第一反应是 Jackson 配置没配好，翻来覆去检查 ObjectMapper 设置，结果发现根源其实在 Lombok 的 @Jacksonized 注解身上。

这个注解的设计初衷是好的：自动生成兼容 Jackson 的 Builder 模式，省去手动写 @JsonDeserialize 的麻烦。但它有一个致命缺陷——当类存在继承关系时，@Jacksonized 只处理当前类的直接字段，对父类中通过 @JsonProperty 声明的 protected 或 private 字段视而不见。于是 Jackson 反序列化时，试图把 JSON 里的字段（比如 "recipient"）绑定到 Child$ChildRequestBuilder 上，可这个 Builder 类压根没声明 recipient 属性（只包含 use_case），自然就抛出 UnrecognizedPropertyException 了。

那么，正确的解法是什么？

1. 移除 @Jacksonized（推荐做法）
如果你不需要用 Builder 模式来参与反序列化（只是简单调用 new ObjectMapper().readValue(..., Child.class)），那最省事的办法就是把 @Jacksonized 去掉，只保留 @Builder。这样一来，Jackson 会通过标准的 setter 或字段反射，正常解析继承链上的所有 @JsonProperty 字段，父类字段自然就能被识别了：

// Parent 类（移除 @Jacksonized）
@Builder
@EqualsAndHashCode
@ToString
@Getter
@Setter
@JsonInclude(JsonInclude.Include.NON_NULL)
@AllArgsConstructor
@NoArgsConstructor
@JsonTypeInfo(use = JsonTypeInfo.Id.DEDUCTION)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Child.class, name = "Child")
})
public class Parent implements Serializable {
    private static final long serialVersionUID = 6223930820946596247L;

    @JsonProperty("recipient")
    protected Recipient recipient; // ✅ 可被 Jackson 正确识别
}

2. 如果实在要保留 @Jacksonized，就得手动扩展 Builder
通过 @Singular、@Builder.Default 或 @Builder(builderMethodName = "...") 配合 @Jacksonized 的 builder 参数，把父类字段也加到 Builder 里。但这么做复杂度高，而且容易出错，对于继承场景来说，真心不推荐。

3. 补充一些关键配置，让系统更健壮
确保 ObjectMapper 启用了子类型推断和字段访问：

ObjectMapper mapper = new ObjectMapper();
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); // 可选：忽略未知字段
mapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);
// 若使用 DEDUCTION，确保子类有明确的 JSON 结构差异（如唯一字段），否则建议改用 PROPERTY 或 NAME

⚠️ 注意事项

• @JsonTypeInfo(use = DEDUCTION) 要求子类 JSON 具有足够区分度（比如 Child 必须包含 "use_case" 字段），否则类型推断可能失败；
• protected 字段必须配合 @JsonProperty 才能被 Jackson 访问（默认不扫描受保护成员）；
• @Builder 生成的 build() 方法仍可正常使用，不影响对象构建逻辑。

总结一下：@Jacksonized 就像一把双刃剑——它简化了 Builder 序列化，却牺牲了继承兼容性。在涉及父子类反序列化的场景中，优先移除 @Jacksonized，依赖 Jackson 原生的字段/Setter 解析机制，才是最稳定、最符合直觉的实践方案。别在复杂的配置里绕圈子，有时候最简单的方案恰恰是最靠谱的。