Jackson 能自动将带 type 字段的 JSON 数组反序列化为子类对象列表,前提是正确配置 @JsonTypeInfo 与 @JsonSubTypes、注册子类、使用 TypeReference 指定泛型,并确保 JSON 中类型标识字段名和值严格匹配声明。

直接说结论:用 @JsonTypeInfo + @JsonSubTypes 注解在基类上声明多态规则,并确保 JSON 中有明确的类型标识字段(如 "type" 或 "messageType"),Jackson 就能自动把 JSON 数组反序列化为具体子类对象的 List,无需手动判断或 if-else。
JSON 必须带 type 字段,且位置要对
Jackson 的多态反序列化不是“猜类型”,而是严格匹配你声明的标识字段。如果 JSON 长这样:
[{"make":"Ford","model":"Focus"},{"make":"Toyota","model":"Tacoma","maxLoad":1050}]
——它没有 type 字段,Jackson 根本不知道第二个对象该映射成 Truck 还是 Car,会直接报 UnrecognizedPropertyException。
正确做法是让上游加字段,或用预处理补全。常见合法结构包括:
-
{"type":"car","make":"Ford","model":"Focus"}(type在对象内部) -
{"messageType":6,"payload":{"url":"xxx"}}(需配合JsonTypeInfo.As.EXTERNAL_PROPERTY) -
{"@class":"com.example.Truck","make":"Toyota","maxLoad":1050}(CLASS策略,慎用)
@JsonTypeInfo 的 use 和 property 参数必须匹配 JSON
这两个参数决定了 Jackson 去哪找、怎么读类型信息。错配 = 反序列化失败。
最常用组合是:
-
use = JsonTypeInfo.Id.NAME:靠逻辑名(如"car"、"truck")查注册表 -
property = "type":要求每个 JSON 对象里都有"type": "xxx"字段
如果 JSON 用的是 "msgType",你就得写 property = "msgType";如果类型值是数字 7,就得用 Id.CUSTOM 配合自定义解析器,不能硬套 NAME。
别漏掉 visible = true(尤其用 NAME 时),否则序列化出的 JSON 不带 type 字段,下游无法反解。
子类必须显式注册,不能只靠继承关系
Jackson 不会自动扫描子类。哪怕 Truck extends Car,不注册,它就永远当 Car 解。
注册方式有两种:
- 注解方式(推荐):
@JsonSubTypes({@Type(value = Truck.class, name = "truck")})写在基类上 - 运行时注册:
mapper.registerSubtypes(Truck.class),适合动态加载场景
注意 name 值必须和 JSON 中的字符串完全一致(大小写敏感),且不能重复。多个子类共用一个 name 会导致随机覆盖。
数组反序列化要指定泛型类型,不能只写 List.class
这是最容易翻车的操作:
mapper.readValue(json, List.class); // ❌ 全变成 LinkedHashMap
必须用 TypeReference 保留泛型信息:
mapper.readValue(json, new TypeReference<list>>() {}); // ✅</list>
否则 Jackson 默认按 Map 处理每个对象,你拿到的是 List,字段全丢,还看不出错在哪。
如果基类是抽象的(比如 abstract class Message),也要确保目标类型写的是基类,不是具体子类——Jackson 会根据 type 字段自己选。
真正麻烦的不是配置,而是协调:JSON 结构、注解声明、子类注册、反序列化调用这四者必须严丝合缝。少对一环,就退化成 Map 填充,或者直接抛异常。尤其当类型字段在兄弟节点(如 messageType 和 payload 并列)时,EXTERNAL_PROPERTY 的用法很容易被忽略,导致 payload 死活不进子类。











