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<Car>>() {}); // ✅
否则 Jackson 默认按 Map 处理每个对象，你拿到的是 List<linkedhashmap></linkedhashmap>，字段全丢，还看不出错在哪。
如果基类是抽象的（比如 abstract class Message），也要确保目标类型写的是基类，不是具体子类——Jackson 会根据 type 字段自己选。
真正麻烦的不是配置，而是协调：JSON 结构、注解声明、子类注册、反序列化调用这四者必须严丝合缝。少对一环，就退化成 Map 填充，或者直接抛异常。尤其当类型字段在兄弟节点（如 messageType 和 payload 并列）时，EXTERNAL_PROPERTY 的用法很容易被忽略，导致 payload 死活不进子类。
