当使用 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 组合——简洁、稳定、无歧义。
? 验证建议
- 运行反序列化测试前，可先打印生成的 JSON 字符串，确认结构是否符合预期；
- 启用 Jackson 调试日志（如 logging.level.com.fasterxml.jackson=DEBUG）观察字段绑定路径；
- 若仍需 Builder 支持，考虑手动编写静态 from() 方法或使用 @JsonCreator 显式构造，避免隐式 Builder 干预。
总之，在涉及类继承的 Jackson 场景中，应警惕 @Jacksonized 的“过度自动化”行为——明确控制序列化契约，比依赖注解黑盒更可靠。
