writeReplace() 方法允许在序列化前将对象替换为代理对象。它必须是 private、无参、返回 Object 类型，JVM 会序列化其返回值而非原对象，常用于隐藏敏感字段、减小体积或适配版本差异。
Java 序列化中，writeReplace() 方法允许你在对象被真正序列化之前，将其替换成另一个对象（比如轻量级代理、DTO 或占位符）。这常用于隐藏敏感字段、减少传输体积、解耦序列化逻辑，或适配不同版本的类结构。
writeReplace() 的作用机制
当一个对象实现了 Serializable，且定义了无参、返回非 void 的 private Object writeReplace() 方法，JVM 在调用 ObjectOutputStream.writeObject() 时会自动检测并调用它。若该方法返回非 null 对象，JVM 就序列化这个返回值，而不是原对象本身。原对象不会进入字节流，也不会触发其 writeObject() 自定义逻辑。
注意：该方法必须是 private、无参数、返回 Object 类型，否则会被忽略。
典型使用场景与写法
常见做法是让原对象返回一个专为序列化设计的代理类实例（如静态内部类或独立 DTO），该代理只包含必要字段，并可实现 Serializable。
立即学习“Java免费学习笔记（深入）”；
- 代理对象通常不含业务逻辑，仅作数据载体，避免反序列化时依赖原始类的复杂初始化
- 代理类建议声明
serialVersionUID，防止因类结构微调导致兼容性问题 - 代理对象的
readResolve()可选——如果希望反序列化后还原成原始类型（而非代理），可在代理类里定义它
一个完整示例
假设有一个含大量缓存或不可序列化资源的 User 类：
public class User implements Serializable {
private static final long serialVersionUID = 1L;
private String name;
private transient Map<String, Object> cache; // 不序列化
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
this.cache = new HashMap<>(); // 运行时数据，不传
}
private Object writeReplace() {
return new UserProxy(name, age);
}
// 静态代理类，轻量、无副作用
private static class UserProxy implements Serializable {
private static final long serialVersionUID = 2L;
private final String name;
private final int age;
UserProxy(String name, int age) {
this.name = name;
this.age = age;
}
// 可选：反序列化后还原为 User 实例
private Object readResolve() {
return new User(name, age);
}
}
}
这样，网络传输或文件保存的只是 UserProxy 的两个字段，既安全又高效。
注意事项与陷阱
writeReplace() 是单向替换机制，仅影响序列化过程；反序列化时默认得到的是代理对象，除非代理自己实现 readResolve() 主动还原。
- 不要在
writeReplace()中抛异常，会导致序列化失败 - 代理对象若需跨 JVM 使用，确保其类在接收端类路径中可用
- 若原类有自定义
readObject()，它不会被调用——因为原对象根本没进流里 - 继承关系中，子类未重写
writeReplace()时会沿用父类逻辑；若需差异化处理，子类应显式提供
