Jackson多态序列化：如何移除超类型属性外层包装？

问题根因 #

@JsonUnwrapped 注解不生效是默认实现的限制：你在Product类上配置的JsonTypeInfo.As.WRAPPER_OBJECT会为多态实例动态生成一层以类型名为key的包装对象，这层动态生成的包装逻辑和@JsonUnwrapped的静态字段展开逻辑不兼容，默认序列化器不会穿透多态包装层完成展开。

可行实现 #

方案1：自定义序列化器（无侵入，无需修改原有Product/子类注解） #

这个方案不需要改动你已经写好的多态配置，只需要给Cart类的product字段绑定自定义序列化器，直接将多态实例的内容合并到Cart的根输出层级，不会生成product字段包裹。

1. 修改Cart类，给product字段添加序列化器注解：

public class Cart {
   private long id;
   private LocalDateTime date;
   @JsonSerialize(using = ProductUnwrappedSerializer.class)
   private Product product;

   // 省略原有getter、setter方法
}

2. 实现自定义展开序列化器：

public class ProductUnwrappedSerializer extends StdSerializer<Product> {
    protected ProductUnwrappedSerializer() {
        super(Product.class);
    }

    @Override
    public void serialize(Product product, JsonGenerator gen, SerializerProvider provider) throws IOException {
        // 直接写入Product实例，不输出外层product字段名
        gen.writeObject(product);
    }

    @Override
    public boolean isUnwrappingSerializer() {
        // 标记为展开模式，跳过字段键写入
        return true;
    }
}

如果需要支持反向反序列化，可以在Cart类中添加@JsonAnySetter方法捕获动态的类型键，匹配对应子类解析：

@JsonAnySetter
public void parseDynamicProduct(String typeKey, JsonNode value) throws JsonProcessingException {
    ObjectMapper mapper = new ObjectMapper();
    switch (typeKey) {
        case "flying_car":
            this.product = mapper.treeToValue(value, FlyingCar.class);
            break;
        case "water_proof_phone":
            this.product = mapper.treeToValue(value, WaterProofPhone.class);
            break;
        case "electric_bicycle":
            this.product = mapper.treeToValue(value, ElectricBicycle.class);
            break;
        default:
            throw new IllegalArgumentException("未知产品类型: " + typeKey);
    }
}

序列化后输出的JSON结构完全符合预期：

{
  "id": 1001,
  "date": "2024-06-01T10:30:00",
  "flying_car": {
    "verticalSpeed": 123.5,
    "name": "StarShip"
  }
}

方案2：全局调整多态配置（适合无其他Product序列化场景的情况） #

如果你的Product类不需要在其他序列化场景保留WRAPPER_OBJECT的包装结构，可以直接修改类上的@JsonTypeInfo配置，配合@JsonUnwrapped实现效果：

注意：这个方案会修改Product全局的序列化规则，所有序列化Product的场景都会生效，使用前请确认其他业务场景兼容。

// 调整include属性为EXISTING_PROPERTY，关闭全局包装
@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, visible = true)
@JsonSubTypes({
        @JsonSubTypes.Type(value = FlyingCar.class, name = "flying_car"),
        @JsonSubTypes.Type(value = WaterProofPhone.class, name = "water_proof_phone"),
        @JsonSubTypes.Type(value = ElectricBicycle.class, name = "electric_bicycle")
})
public abstract class Product {
    // 新增类型字段，输出类型名
    @JsonIgnore
    public abstract String getType();
}

// 子类实现getType方法
@JsonTypeName("flying_car")
public class FlyingCar extends Product {
     private double verticalSpeed; 
     private String name;

     @Override
     public String getType() {
         return "flying_car";
     }
}

之后在Cart的product字段上加@JsonUnwrapped即可，但这个方案需要给所有子类加类型字段和实现方法，侵入性更高，优先选择方案1。

内容的提问来源于stack exchange，提问作者akuma8