Java泛型序列化核心问题是反序列化时类型信息丢失，因泛型擦除导致元素被还原为LinkedHashMap；解决关键是反序列化时显式传入TypeReference或TypeToken，并避免raw type用法。
Java 中序列化包含泛型的集合对象时，核心问题不是“序列化本身失败”，而是反序列化后类型信息丢失——因为泛型擦除导致运行时无法知道 List<User> 里的 User 是什么类型，框架（如 Jackson、Gson）默认会把元素还原成 LinkedHashMap，一调用 user.getName() 就抛 ClassCastException 或空指针。
解决的关键不是绕过擦除，而是在反序列化时主动把被擦除的泛型结构“告诉”框架。以下是实际项目中稳定有效的做法：
明确传入 TypeReference 或 TypeToken
这是最常用、最推荐的方式。它利用匿名子类在运行时保留泛型签名的特性，让 JSON 库能准确重建嵌套类型。
-
Jackson 示例：
立即学习“Java免费学习笔记（深入）”；
List<User> users = objectMapper.readValue(json, new TypeReference<List<User>>() {}); Map<String, List<OrderItem>> data = objectMapper.readValue(json, new TypeReference<Map<String, List<OrderItem>>>() {}); -
Gson 示例：
List<User> users = gson.fromJson(json, new TypeToken<List<User>>() {}.getType());
⚠️ 注意：必须写 {}，否则 getGenericSuperclass() 拿不到泛型信息，等同于没传。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
别用 raw type 反序列化
像下面这些写法是典型错误，会导致类型彻底丢失：
- ❌
objectMapper.readValue(json, List.class) - ❌
gson.fromJson(json, List.class) - ❌
redisTemplate.opsForValue().get(key)后直接(List<User>) value
正确做法是：先取原始字符串，再用 ObjectMapper 按需解析，且必须带 TypeReference。
多态泛型容器要开启类型识别
如果 List<Person> 里混了 Student 和 Teacher 子类，仅靠 TypeReference<List<Person>> 不够——反序列化仍全变成 Person 实例。
需要配置 Jackson 启用默认类型识别：
ObjectMapper mapper = new ObjectMapper();
mapper.activateDefaultTyping(
LaissezFaireSubTypeValidator.instance,
ObjectMapper.DefaultTyping.NON_FINAL
);这样序列化出的 JSON 会带 @class 字段，反序列化时自动实例化对应子类。
业务场景优先用具体 DTO，少依赖泛型响应体
比如统一返回结构 Result<T>，与其每次反序列化都写 new TypeReference<Result<User>>() {}，不如定义一个 UserResult extends Result<User>。
好处是：类型固化、IDE 可提示、无需动态传参、避免泛型层层嵌套带来的维护成本。
本质上，泛型擦除不可逆，但你可以控制“在哪一层补回类型”。关键动作永远发生在反序列化入口处——把 List<User> 这个完整结构显式交出去，而不是指望框架猜。
