Jackson 多态反序列化详解：基于字段自动选择子类的优雅方案

在进行 JSON 解析时，我们经常遇到这样的场景：

同一个父类型下包含多种不同的子类，而 JSON 中会通过某个字段标识具体类型。例如，一个系统的日志可能有：

普通消息
错误消息
告警消息

JSON 长得可能是这样：

java 复制代码

{
  "type": "error",
  "code": 500,
  "message": "Something failed"
}

如果我们写大量的 if-else 或 switch-case 来判断 type 再手动选类去解析，不仅繁琐，还非常不优雅。

Jackson 给我们提供了一套成熟的多态反序列化机制，能够根据 JSON 中的某个字段，自动选择对应的子类来构造对象。

这篇文章带你彻底理解这套机制怎么用、怎么工作、为什么合理。

一、核心模型：一个抽象父类 + 多个子类

先看这段关键代码：

java 复制代码

@JsonTypeInfo(
        use = JsonTypeInfo.Id.NAME,
        property = "type",
        include = JsonTypeInfo.As.EXISTING_PROPERTY,
        defaultImpl = JsonNode.class
)
@JsonSubTypes({
        @JsonSubTypes.Type(value = InfoLog.class, name = "info"),
        @JsonSubTypes.Type(value = WarningLog.class, name = "warning"),
        @JsonSubTypes.Type(value = ErrorLog.class, name = "error")
})
public abstract class LogEntry {
    private String type;
}

你只需要关注三点：

由 type 字段决定解析成哪个类
不需要手动判断类型
未知类型自动 fallback 到 JsonNode（不会崩）

二、子类长什么样？

例如：

java 复制代码

public class InfoLog extends LogEntry {
    private String message;
}

public class WarningLog extends LogEntry {
    private String message;
    private int level;
}

public class ErrorLog extends LogEntry {
    private int code;
    private String message;
}

只要继承了 LogEntry，Jackson 就能根据 type 自动选它。

三、反序列化示例：一点代码就能完成多态解析

java 复制代码

ObjectMapper mapper = new ObjectMapper();

String json = "{ \"type\": \"error\", \"code\": 500, \"message\": \"Oops\" }";

LogEntry log = mapper.readValue(json, LogEntry.class);

System.out.println(log.getClass());

运行输出：

复制代码

class ErrorLog

Jackson 自动选择了 ErrorLog，并将字段填充完毕。

注意：最终对象仍然包含父类的 type 字段。

也就是说：

复制代码

log.getType(); // 仍然等于 "error"

Jackson 不会把它丢掉。

四、Jackson 内部到底怎么做？

机制其实非常简单，Jackson 内部的流程是：

读取 JSON
找到指定字段，例如 type
根据 JsonSubTypes 的映射找到目标类
实例化该子类
将 JSON 的所有字段填入对象（包括父类字段）

这意味着：

最终对象一定是某个子类实例
父类字段仍然保留在对象中
不会产生额外的"套娃"包装结构

这是很多人最容易误解的点：

Jackson 不会生成一个"父类 + 子类"的嵌套结构，它只会生成一个子类对象。

五、为什么这个模式值得使用？

优点非常明显：

反序列化逻辑简单到极致，无需手写 if-else
可扩展性强，新增子类只要添加到 JsonSubTypes
JSON 结构干净，不需要额外的 @type 注入
未知类型安全 fallback（不会影响运行）

适用于任何需要"根据字段选择对象类型"的场景，例如：

不同类型的日志
不同格式的通知事件
数据导入时的多种记录格式
后端与前端协商统一的 polymorphic JSON

六、一些常见误区与正确理解

误区 1：最终返回的对象里不会包含 type 字段

错误。

因为 include = EXISTING_PROPERTY，type 会保留并被赋值到父类字段。

误区 2：Jackson 会生成一个父类，然后在里面套一个子类

错误。

Jackson 最终只生成一个子类实例，父类字段由继承关系自然包含。

误区 3：必须给子类加 `@JsonTypeName`

不需要，有 @JsonSubTypes 已经足够。

七、总结

这套 Jackson 多态反序列化方案非常适合处理"统一入口，多种类型"的 JSON 数据。

它的思路本质上就是：

让 JSON 自己告诉我们它是什么类型，我们只需要根据字段自动选择子类。

核心点只有三行：

@JsonTypeInfo 指定"用哪个字段判断类型"
@JsonSubTypes 指定"映射关系是什么"
父类字段始终会被保留下来

整个机制优雅、稳定、可维护性高，是 JSON 多态处理的标准做法。

如果你在项目中也遇到类似需求，这套模式可以直接拿去使用。

Jackson 多态反序列化详解：基于字段自动选择子类的优雅方案