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...
}序列化/反序列化代码保持不变：
List<AnEntity> list = List.of(new AnEntity(10, "aaa"), new AnEntity(20, "bbb"));
UserMessageResult<List<AnEntity>> result = new UserMessageResult<>(list);
String json = MAPPER.writeValueAsString(result);
// 输出: {"entity":[{"anInt":10,"aString":"aaa"},{"anInt":20,"aString":"bbb"}]}
UserMessageResult<List<AnEntity>> restored = MAPPER.readValue(
json,
new TypeReference<UserMessageResult<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;
// ...
}然后反序列化时使用原始类型（非 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注入时机，但开发成本高，仅推荐框架级封装使用。
综上，根据是否需要运行时多态，选择「移除注解 + TypeReference」或「字段级 @JsonTypeInfo + 原始类型反序列化」，即可彻底规避该异常，确保泛型 List 在 Jackson 2.15+ 中稳定工作。
