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

浅婷小哥_9390

发布时间：2026-07-13 14:58:02

747人浏览过

来源于php中文网

原创

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

当使用 Lombok 的 @Jacksonized 注解时，Jackson 在反序列化子类时可能忽略继承自父类的字段（如 recipient），导致 UnrecognizedPropertyException；根本原因在于 @Jacksonized 会强制 Jackson 使用 Lombok 生成的 Builder 进行反序列化，而该 Builder 默认仅识别子类显式声明的字段，不包含父类字段。

当使用 lombok 的 `@jacksonized` 注解时，jackson 在反序列化子类时可能忽略继承自父类的字段（如 `recipient`），导致 `unrecognizedpropertyexception`；根本原因在于 `@jacksonized` 会强制 jackson 使用 lombok 生成的 builder 进行反序列化，而该 builder 默认仅识别子类显式声明的字段，不包含父类字段。

在面向继承的 JSON 序列化/反序列化场景中，@Jacksonized 是一把双刃剑：它能简化 Builder 模式与 Jackson 的集成，但默认行为不支持继承链中父类字段的自动识别。正如示例所示，Child 类继承自 Parent，且 Parent 中定义了 @JsonProperty("recipient") protected Recipient recipient;，但在反序列化 JSON 字符串时，Jackson 却报错：

Unrecognized field "recipient" 
(class a.b.Child$ChildRequestBuilder), 
not marked as ignorable (1 known properties: "use_case")

这说明 Jackson 正试图将 "recipient" 字段注入到 Child 的内部 Builder（即 Child$ChildRequestBuilder）中，但该 Builder 由 @Jacksonized 自动生成，且未声明对父类字段的支持。

✅ 正确解决方案：移除或谨慎使用 @Jacksonized

最直接有效的修复方式是 移除 @Jacksonized 注解（尤其在存在继承关系的类层级中）：

// Parent 类保持其他注解，但去掉 @Jacksonized
@Builder
//@Jacksonized ← 删除这一行
@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;
    // ...
}

// Child 类同理移除 @Jacksonized
@Builder(builderMethodName = "childRequestBuilder")
//@Jacksonized ← 删除
@EqualsAndHashCode
@ToString
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
@JsonInclude(JsonInclude.Include.NON_NULL)
public class Child extends Parent implements Serializable {
    private static final long serialVersionUID = -2848064640409441165L;

    @JsonProperty("use_case")
    private String useCase;
}

移除后，Jackson 将回退至标准反射机制（配合 @Getter/@Setter），正确识别并绑定 recipient 等继承字段，测试即可通过。

⚠️ 替代方案（如必须保留 @Jacksonized）

若业务强依赖 @Jacksonized（例如需定制 Builder 构造逻辑），可通过显式配置 Builder 字段映射来支持父类属性：

@Builder
@Jacksonized
// ... 其他注解
public class Parent { ... }

@Builder
@Jacksonized
@SuperBuilder // 替换为 @SuperBuilder（需 Lombok 1.18.20+），支持继承字段
public class Child extends Parent { ... }

⚠️ 注意：@SuperBuilder 是更安全的继承友好型替代方案，但需确保 Lombok 版本 ≥ 1.18.20，且需配合 @Jacksonized 的 builder() 参数指定 Builder 类型（文档中需查阅最新用法）。不过，对于多数项目，优先推荐移除 @Jacksonized 并依赖标准 Jackson + Lombok @Getter/@Setter 组合——简洁、稳定、无歧义。