Gson反序列化多态JSON后父类无法强转子类如何恢复子类功能

现有类定义如下：

1. 父类Bike，包含两个字符串属性：

   public class Bike {
       String name;
       String color;
   }
   

2. 两个继承自Bike的子类：

   public class TrickBike extends Bike {
       public void doTrick() {
           // 特技方法逻辑
       }
   }
   
   public class FailBike extends Bike {
       public void doFail() {
           // 故障方法逻辑
       }
   }
   

3. 用于存放自行车实例的Garage类：

   public class Garage {
       List<Bike> bikes;
   }
   

操作流程：向bikes列表中添加Bike、TrickBike、FailBike三种类型的多个实例，使用Gson将Garage对象序列化为JSON写入文件；后续反序列化读取Garage对象时，无法将列表中原本为TrickBike类型的实例强转为TrickBike调用doTrick()，会抛出类型转换异常。
已知约束：

• 不采纳复制修改Gson源码的方案
• 反序列化目标类型固定为包含List<Bike>属性的Garage类，不接受单独按子类类型读取反序列化的方案

Gson默认处理多态泛型集合时，不会记录集合元素的实际运行时类型。反序列化List<Bike>时，Gson会默认将所有元素创建为基础Bike类型的实例，这些对象的运行时类型就是Bike，和子类不存在继承关系，因此向下强转为TrickBike/FailBike时必然抛出ClassCastException。

安全实现方案 #

• 方案1（最终采纳）：迁移至Jackson框架实现多态序列化/反序列化
  Jackson原生支持多态类型处理，只需要在父类上添加@JsonTypeInfo注解配置类型标签，序列化时会自动在JSON中写入对象的实际子类标识，反序列化时会根据标识自动创建对应类型的实例，全程类型安全，不需要额外手动转换逻辑。
  基础配置示例：

  // 序列化时将实际类名作为@class字段写入JSON
  @JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "@class")
  public class Bike {
      String name;
      String color;
  }
  

  配置完成后，反序列化得到的Garage对象中，bikes列表里的元素会自动还原为原本的Bike/TrickBike/FailBike类型，可直接调用对应子类方法，无强转异常。多态序列化场景下Jackson的原生支持能力优于Gson。
• 方案2（Gson生态合规方案）：自定义类型适配器
  如果必须使用Gson，可自定义TypeAdapterFactory实现：序列化Bike及其子类对象时，主动写入对象的实际类型标识；反序列化时先读取类型标识，再反射创建对应子类的实例填充属性。将该适配器注册到GsonBuilder后，反序列化结果可自动还原正确子类类型，全程类型安全，不需要修改Gson源码、也不需要单独反序列化子类。

非安全实现方案 #

• 反序列化完成后手动遍历bikes列表，根据对象的属性特征（比如特定的name值、子类独有的字段）判断原本的子类类型，手动new对应子类实例、拷贝属性后替换列表中的原Bike对象。该方案完全依赖属性特征的匹配准确性，没有编译期校验，一旦特征匹配错误会生成错误类型的对象，调用方法时会出现不可预期的运行时异常。
• 通过反射直接修改JVM中Bike实例的类型指针，强行将其标记为子类类型。该方案完全违反JVM类型系统规范，会导致内存错乱、虚拟机崩溃等严重问题，禁止使用。

• 对实际类型为FailBike的对象尝试强转TrickBike调用doTrick()：TrickBike和FailBike是平级子类，不存在继承关系，强转时直接抛出ClassCastException，不会进入方法调用逻辑。
• 让基础Bike实例支持调用doTrick()的可行方式：
  • 在Bike父类中添加doTrick()的默认实现，子类按需重写，基础Bike实例调用时执行默认逻辑
  • 通过访问者模式、包装类等结构设计，在不修改继承关系的前提下为基础Bike适配doTrick()的调用逻辑

内容的提问来源于stack exchange，提问作者Shavk with a Hoon