从Serializable对象提取父类并保持向后兼容性

首先我明确你的场景：原本你有一个实现Serializable的MyClass，里面包含字段i，已经序列化了实例到MyClass.ser文件；现在想把i这类字段的逻辑迁移到父类，但直接修改后反序列化旧文件会报错——这是因为Java序列化会记录字段所属的类，旧数据里i属于MyClass，但新结构里i属于父类，JVM无法自动完成字段映射。

下面是具体的解决步骤和代码示例：

1. 保留原类的serialVersionUID #

首先必须显式指定并保持MyClass的serialVersionUID和旧版本完全一致。如果之前没显式定义，你可以用JDK的serialver工具生成旧类的serialVersionUID，然后在新类中声明：

// 旧版本的MyClass示例
public class MyClass implements Serializable {
    // 用serialver工具生成的旧版本ID，必须和这个完全一致
    private static final long serialVersionUID = 123456789L;
    public int i;
}

2. 迁移字段到父类，实现自定义反序列化逻辑 #

创建父类并迁移字段，然后在MyClass中实现readObject方法，手动读取旧数据里属于子类的字段，赋值给父类的对应字段：

package xso.test.serializable;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectInputStream.GetField;
import java.io.Serializable;

// 新的父类，包含迁移过来的字段
class ParentClass implements Serializable {
    private static final long serialVersionUID = 987654321L;
    public int i;
}

// 子类，保持原serialVersionUID不变
public class MyClass extends ParentClass implements Serializable {
    // 必须和旧版本MyClass的serialVersionUID完全一致
    private static final long serialVersionUID = 123456789L;

    // 自定义反序列化方法，处理旧数据的字段映射
    private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException {
        // 读取所有字段（包括JVM识别为"未知"的旧字段）
        GetField fields = ois.readFields();
        
        try {
            // 尝试读取旧版本中属于MyClass的i字段
            int oldI = fields.get("i", 0);
            // 将读取到的值赋值给父类的i字段
            super.i = oldI;
        } catch (IllegalArgumentException e) {
            // 如果是新版本的序列化数据，不存在这个字段，直接忽略
            // 此时父类的i会通过默认反序列化逻辑初始化
        }
    }
}

3. 验证反序列化效果 #

用以下代码测试反序列化旧文件：

package xso.test.serializable;
import java.io.FileInputStream;
import java.io.ObjectInputStream;

public class ReadClass {
    public static void main(String[] args) throws Exception {
        try (ObjectInputStream ois = new ObjectInputStream(new FileInputStream("MyClass.ser"))) {
            MyClass d = (MyClass) ois.readObject();
            System.out.println("反序列化得到的i值：" + d.i); // 应该输出旧数据里的888
        }
    }
}

原理说明 #

Java序列化时会把每个字段的声明类信息写入数据，当字段从子类移到父类后，旧数据中的i被标记为属于MyClass，但新的MyClass已经没有这个字段了。通过自定义readObject方法，我们可以读取这些“未知字段”，手动将值映射到父类的对应字段上，从而兼容旧版本的序列化数据。

内容的提问来源于stack exchange，提问作者Olaf