Spring持久化使用抽象类作为字段类型的Jackson报错解决方案

抛出该异常的核心原因是Jackson无法完成抽象类SpecPayload的反序列化：SpecPayload是抽象类型，Jackson从数据库读取JSON数据映射为对象时，没有足够的类型标识判断应该实例化LinkPayload、CodePayload哪一个具体子类，因此抛出构造实例失败的错误。

直接使用Jackson原生的多态类型序列化/反序列化注解即可解决，你代码中已经存在的type字段可以直接复用作为类型标识，不需要额外修改存储结构。

1. 为SpecPayload抽象类添加多态配置注解，关联已有的type字段和具体子类的映射关系：

import com.fasterxml.jackson.annotation.JsonSubTypes
import com.fasterxml.jackson.annotation.JsonTypeInfo

// 复用Spec类中已存在的type字段作为类型判断依据
@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.EXISTING_PROPERTY,
    property = "type",
    visible = true
)
// 配置每个类型枚举值对应的具体子类
@JsonSubTypes(
    JsonSubTypes.Type(value = LinkPayload::class, name = "LINK"),
    JsonSubTypes.Type(value = CodePayload::class, name = "CODE")
)
abstract class SpecPayload {
    // 原有抽象类逻辑保持不变
}

配置说明：

• include = JsonTypeInfo.As.EXISTING_PROPERTY表示使用对象外层已经存在的type字段做类型判断，不需要Jackson在JSON中额外插入类型标识字段，不会破坏现有已存储的数据结构。
• 注解中name属性的值需要和你实际定义的SpecType枚举序列化后的值完全匹配，否则会出现子类匹配失败的问题。
• visible = true表示反序列化完成后保留type字段的值，不会被Jackson过滤丢弃。

2. 特殊场景适配：如果你的payload字段是单独序列化存储（比如使用JPA @Convert注解将payload独立转为JSON存入数据库字段，和外层type字段无关联），可以调整注解配置，将类型标识直接存在payload的JSON结构内部：

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "payloadType"
)
@JsonSubTypes(
    JsonSubTypes.Type(value = LinkPayload::class, name = "LINK"),
    JsonSubTypes.Type(value = CodePayload::class, name = "CODE")
)
abstract class SpecPayload

该配置会在序列化SpecPayload子类时，自动在JSON中插入payloadType字段存储类型值，反序列化时自动根据该字段识别对应子类，不需要依赖外层Spec的type属性。

• 项目中需要引入jackson-module-kotlin依赖，保证Jackson可以正确识别Kotlin数据类的构造方法，避免出现构造函数匹配失败的问题。如果是Spring Boot项目，引入spring-boot-starter-json依赖会自动集成该模块，不需要额外手动配置ObjectMapper。
• 不要尝试为SpecPayload抽象类添加默认构造方法绕过异常，会导致反序列化生成的对象属性为空，引发业务逻辑错误。
• 如果自定义了JSON字段转换器（比如JPA的AttributeConverter），需要保证转换器使用的ObjectMapper实例注册了Kotlin模块，否则上述注解配置不会生效。

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