Java序列化兼容需用ObjectStreamField显式声明字段布局，并在readObject中手动映射：serialPersistentFields定义字段白名单，readFields安全提取旧值，支持重命名、类型升级与默认值填充。
Java 序列化中，类结构变更（如字段增删、类型调整、重命名）会导致反序列化失败，抛出 InvalidClassException。直接修改 serialVersionUID 并不能解决字段不匹配问题。真正可行的兼容方案是：在新版类中通过 ObjectStreamField 显式声明序列化字段布局，并在 readObject 中手动将旧字段值映射到新字段——这本质上是用“字段级契约”替代默认反射推导。
明确声明序列化字段视图
新版类需定义 private static final ObjectStreamField[] serialPersistentFields 数组，精确列出该版本**期望从字节流中读取的所有字段名与类型**（即使当前类已无对应成员变量）。这个数组就是反序列化时的“字段白名单”和类型依据。
- 字段名必须与旧版序列化字节流中的名称完全一致（区分大小写）
- 类型需兼容：例如旧版是
int，新版可声明为long，但不能声明为String - 新增字段不在此数组中 → 反序列化时不会尝试读取，需在
readObject中赋予默认值 - 已删除字段若仍保留在数组中 → 会尝试读取并丢弃（或可捕获后做迁移逻辑）
在 readObject 中完成字段值提取与映射
覆盖 private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException 方法，在其中调用 in.defaultReadObject() 前，先用 in.readFields() 获取一个 ObjectInputStream.GetField 实例。它能按 serialPersistentFields 声明的字段列表，安全地提取原始值，无论当前类是否存在同名字段。
-
get("oldName", defaultValue)可读取旧字段值，即使新版类没有oldName字段 - 读出的值可赋给新字段、转换类型、合并逻辑（如把
firstName+lastName拼成fullName） - 未在
serialPersistentFields中声明的字段，get调用会抛出IllegalArgumentException
处理字段重命名与类型升级
这是 ObjectStreamField 迁移最典型的场景。例如旧类有 private String userName;，新版改为 private String username;（仅大小写变化）且类型不变：
- 在
serialPersistentFields中仍声明new ObjectStreamField("userName", String.class) -
readObject中调用fields.get("userName", null)获取值，再赋给this.username = ...
再如旧版用 int version，新版升级为 long version：
- 声明
new ObjectStreamField("version", Integer.TYPE)（注意是Integer.TYPE，非Long.TYPE） - 读取时用
fields.get("version", 0)得到int，再转为long赋值
避免常见陷阱
这种手动迁移方式灵活但易出错，需特别注意：
-
serialPersistentFields数组必须是static final，且字段顺序无关，但名称和类型必须严格匹配字节流 - 不要在
readObject中调用defaultReadObject()后再调用readFields()—— 字节流已被消耗，会抛出StreamCorruptedException - 如果旧类本身已有自定义
writeObject，新版readObject必须理解其输出格式，否则字段提取可能错位 - 继承关系复杂时，父类也需各自维护自己的
serialPersistentFields和readObject
