Jackson 如何自动解析多类型 JSON 列表

Jackson 能够智能地将包含类型标识字段（如 "type"）的 JSON 数组自动反序列化为对应子类对象的列表，但前提是严格统一配置：在基类上用 @JsonTypeInfo 和 @JsonSubTypes 声明多态规则，确保 JSON 中存在且仅存在匹配的类型字段（大小写敏感、位置准确），显式注册所有子类，并使用 TypeReference 指定泛型类型——任何一环错位（比如字段名不一致、漏注册子类、误用 List.class 而非 TypeReference），都会导致反序列化退化为 LinkedHashMap 或直接抛异常，真正考验的是 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>() {}); // ✅

否则 Jackson 默认按 Map 处理每个对象，你拿到的是 List，字段全丢，还看不出错在哪。

如果基类是抽象的（比如 abstract class Message），也要确保目标类型写的是基类，不是具体子类——Jackson 会根据 type 字段自己选。

真正麻烦的不是配置，而是协调：JSON 结构、注解声明、子类注册、反序列化调用这四者必须严丝合缝。少对一环，就退化成 Map 填充，或者直接抛异常。尤其当类型字段在兄弟节点（如 messageType 和 payload 并列）时，EXTERNAL_PROPERTY 的用法很容易被忽略，导致 payload 死活不进子类。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。