Jackson反序列化实现接口的抽象类子类失败问题排查

你遇到的问题核心是多态类型注解的层级不匹配，导致Jackson找不到对应的子类型映射，我来帮你拆解和解决：

问题根源 #

你把@JsonTypeInfo和@JsonSubTypes标注在了顶层的Event接口上，但实际反序列化时，你的目标类型是SpecificEvent抽象类——不管是RabbitMQ监听方法的参数类型，还是消息转换器默认处理的目标类型，都是这个抽象类。Jackson在解析时，会在SpecificEvent的层级查找类型映射配置，但这个类上没有任何多态注解，自然找不到childA对应的子类，所以抛出了类型解析失败的错误。

两种可行的解决方案 #

方案一：把多态注解移到抽象类SpecificEvent上 #

这是最直接的解决方式，因为你的子类都是直接继承自SpecificEvent，把类型注解放在这个抽象类上，Jackson就能正确关联type字段和对应的子类：

修改后的代码如下：

// 顶层接口不需要多态注解
public interface Event { }

// 将多态注解移到抽象类上
@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "type")
@JsonSubTypes({
    @JsonSubTypes.Type(value = ChildA.class, name = "childA"),
    @JsonSubTypes.Type(value = ChildB.class, name = "childB"),
})
public abstract class SpecificEvent implements Event {
    private ZonedDateTime timestamp;
    
    // 记得添加上getter和setter方法，否则Jackson无法正确处理timestamp字段的序列化/反序列化
}

public class ChildA extends SpecificEvent { }
public class ChildB extends SpecificEvent { }

方案二：保持注解在Event接口，但监听方法使用Event作为参数 #

如果你不想移动注解的位置，可以调整RabbitMQ监听方法的参数类型为Event，这样Jackson在反序列化时会以Event为目标类型，就能读取到接口上的多态配置：

@RabbitListener(queues = "your-target-queue")
public void handleEvent(Event event) {
    // 根据实际类型做处理
    if (event instanceof ChildA childA) {
        // 处理ChildA逻辑
    } else if (event instanceof ChildB childB) {
        // 处理ChildB逻辑
    }
}

额外注意事项 #

1. 确保SpecificEvent类中的timestamp字段有对应的getter和setter方法，否则Jackson无法正确处理该字段的序列化/反序列化。
2. 检查你的ObjectMapper配置，没有禁用多态类型处理的相关配置（比如MapperFeature.USE_BASE_TYPE_AS_DEFAULT_IMPL），你的当前配置看起来是没问题的。

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