解决 Jackson 序列化/反序列化泛型 List 时丢失类型信息的问题-java教程-PHP中文网

解决 Jackson 序列化/反序列化泛型 List 时丢失类型信息的问题

Jackson 在处理带 @JsonTypeInfo 的泛型类型（如 UserMessageResult）时，因类型擦除与多层嵌套导致子元素缺失 @class 标识，引发 InvalidTypeIdException；本文提供两种稳定、兼容 Jackson 2.15+ 的解决方案。

jackson 在处理带 `@jsontypeinfo` 的泛型类型（如 `usermessageresult>`）时，因类型擦除与多层嵌套导致子元素缺失 `@class` 标识，引发 `invalidtypeidexception`；本文提供两种稳定、兼容 jackson 2.15+ 的解决方案。

Jackson 2.15 起对泛型集合中嵌套类型的 @JsonTypeInfo 处理逻辑发生重要变更：当 UserMessageResult<t></t> 的字段 entity 是 List<anentity></anentity> 且 AnEntity 自身声明了 @JsonTypeInfo(use = Id.CLASS, include = As.PROPERTY) 时，Jackson 默认不会自动为 List 中每个元素注入 @class 字段——除非显式告知其完整泛型结构且启用类型信息传播机制。而 TypeReference<usermessageresult>>></usermessageresult> 仅向反序列化器传递了“目标类型”，并未激活 Jackson 对 List 内部元素的类型标识生成逻辑，最终导致 JSON 中 entity 数组内对象缺少 @class 属性，抛出 InvalidTypeIdException。

✅ 方案一：移除 `@JsonTypeInfo`，依赖 `TypeReference`（推荐用于类型已知场景）

若业务中反序列化时类型完全确定且无需运行时动态识别子类，最简洁可靠的方案是移除所有 @JsonTypeInfo 注解，完全由 TypeReference 驱动类型推断：

// 移除 @JsonTypeInfo 注解
public static class UserMessageResult<t> {
    private T entity;

    public UserMessageResult() {}
    public UserMessageResult(T entity) { this.entity = entity; }
    // getter/setter...
}

@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY)
// ❌ 删除此行！否则仍会触发类型检查失败
public static class AnEntity {
    private int anInt;
    private String aString;
    // 构造函数、getter/setter...
}</t>

序列化/反序列化代码保持不变：

List<anentity> list = List.of(new AnEntity(10, "aaa"), new AnEntity(20, "bbb"));
UserMessageResult<list>> result = new UserMessageResult(list);

String json = MAPPER.writeValueAsString(result);
// 输出: {"entity":[{"anInt":10,"aString":"aaa"},{"anInt":20,"aString":"bbb"}]}

UserMessageResult<list>> restored = MAPPER.readValue(
    json,
    new TypeReference<usermessageresult>>>() {}
);</usermessageresult></list></list></anentity>

✅ 优势：零配置、无歧义、兼容性最佳；适用于 DTO 层明确、无继承多态需求的场景。

✅ 方案二：保留 `@JsonTypeInfo`，改用原始类型 + `@JsonSubTypes`（适用于需运行时多态）

若必须保留类型标识（例如 AnEntity 存在子类，需反序列化为具体实现类），则不能使用 TypeReference，而应：

移除 AnEntity 类上的 @JsonTypeInfo（避免双重标注冲突）；
在 UserMessageResult 的 entity 字段上直接声明类型信息，并配合 @JsonSubTypes 显式注册支持的子类型：

public static class UserMessageResult<t> {
    @JsonTypeInfo(
        use = JsonTypeInfo.Id.NAME,
        include = JsonTypeInfo.As.PROPERTY,
        property = "@class"
    )
    @JsonSubTypes({
        @JsonSubTypes.Type(value = AnEntity.class, name = "AnEntity")
        // 可添加其他子类...
    })
    private T entity;

    // 构造函数、getter/setter...
}

// AnEntity 不再加 @JsonTypeInfo
public static class AnEntity {
    private int anInt;
    private String aString;
    // ...
}</t>

然后反序列化时使用原始类型（非 TypeReference）：

String json = MAPPER.writeValueAsString(result);
// 输出含 type id: {"entity":[{"@class":"AnEntity","anInt":10,"aString":"aaa"}, ...]}

// ✅ 关键：直接传入 Class，而非 TypeReference
UserMessageResult> restored = MAPPER.readValue(json, UserMessageResult.class);

⚠️ 注意：此时 restored.getEntity() 返回 Object，需手动 instanceof 或 Class.cast() 转换为 List<anentity></anentity>。

? 补充说明与避坑提示

不要混合使用 TypeReference 和 @JsonTypeInfo 处理泛型集合：这是 Jackson 2.15+ 的已知行为变更，官方文档强调 TypeReference 优先于注解，但对嵌套泛型中的子类型标识不生效。
手动补全 @class 并不可靠：如问题中所示，硬编码 JSON 易出错（如字段名大小写不一致导致 Unrecognized field "aString"），且丧失可维护性。
验证 Jackson 版本：该问题在 2.15.0+ 明确复现，2.14.x 及更早版本存在宽松回退逻辑，但不建议降级。
替代方案：自定义序列化器（进阶）：对 List<anentity></anentity> 注册 StdSerializer + StdDeserializer，可完全控制 @class 注入时机，但开发成本高，仅推荐框架级封装使用。