writeObject 和 readObject 是 Java 中用于自定义序列化行为的私有方法,需声明为 private void,参数分别为 ObjectOutputStream 和 ObjectInputStream;它们在类实现 Serializable 且需控制序列化细节时使用,可跳过敏感字段、加密数据、保证状态合法或兼容旧版本格式。

在 Java 中,writeObject 和 readObject 是用于自定义序列化行为的私有方法,必须声明为 private void,且参数固定(ObjectOutputStream 或 ObjectInputStream)。它们只在类实现了 Serializable 接口,并且需要控制序列化细节时才需手动编写。
为什么要自定义 writeObject 和 readObject
默认序列化会保存所有非 transient、非 static 字段,但有时你希望:
- 跳过某些敏感字段(比如密码),即使它没加
transient - 对字段做加密/压缩/转换后再写入(如把
Date存为时间戳) - 保证反序列化时对象状态合法(比如重建不可变字段、校验数据一致性)
- 兼容旧版本序列化格式(比如字段重命名、类型变更)
基本写法和注意事项
两个方法必须严格满足签名,且为 private;JVM 会在序列化/反序列化时通过反射调用它们。记得先调用 defaultWriteObject() / defaultReadObject() 来处理默认字段,除非你完全自己管理所有字段。
示例:
在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。
private void writeObject(ObjectOutputStream out) throws IOException {
out.defaultWriteObject(); // 先序列化默认字段
out.writeLong(System.currentTimeMillis()); // 自定义写入当前时间戳
}
private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException {
in.defaultReadObject(); // 先恢复默认字段
long savedTime = in.readLong(); // 读取自定义数据
this.lastModified = new Date(savedTime); // 赋值给 transient 字段或其他逻辑
}
注意:writeObject 中不能直接调用 out.writeObject(this)(会无限递归),readObject 中也不能 new 当前对象再赋值——反序列化过程已创建好实例,你只是在填充它。
常见使用场景与写法技巧
✅ 保护敏感字段:即使字段没标 transient,也可在 writeObject 中跳过写入
✅ 修复 transient 字段:在 readObject 中重新计算或从其他字段推导(如缓存、懒加载对象)
✅ 版本兼容:旧版字段名是 userName,新版改为 username,可在 readObject 中尝试读旧字段并 fallback
✅ 验证反序列化结果:读完后检查关键字段是否为空或非法,抛出 InvalidObjectException
不推荐:在 readObject 中启动线程、打开文件、连接数据库——反序列化应是纯数据重建过程,避免副作用。
替代方案与现代建议
如果逻辑复杂或需跨语言,考虑用 JSON(Jackson/Gson)、Protocol Buffers 等显式序列化框架,比 Java 原生序列化更可控、安全、可读。
Java 17+ 引入了 Serializable 的新机制(如 serialPersistentFields、readResolve),但 writeObject/readObject 仍是主流兼容写法。
⚠️ 注意:启用自定义序列化后,务必同步维护两个方法,否则易出现 StreamCorruptedException 或字段丢失。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










