只有被声明为transient的实例变量才会在Java默认序列化中被跳过;静态字段、方法等本不参与序列化;transient对JSON库无效,需用对应注解;它不影响serialVersionUID计算,但类结构变动仍需更新该值。

Java序列化时哪些字段会被自动忽略
只有被声明为 transient 的实例变量,才会在默认 Java 序列化(ObjectOutputStream)过程中跳过。静态字段、方法、构造器本来就不参与序列化,和 transient 无关。
常见错误现象:加了 transient 却还是被序列化了——大概率是因为用了 JSON 库(如 Jackson、Fastjson),它们默认不认 transient,得靠注解或配置干预。
-
transient只对java.io.Serializable生效,对Externalizable无效(后者完全由你控制读写逻辑) - 字段类型要是可序列化的,否则即使没标
transient,序列化也会抛NotSerializableException - 子类继承父类字段时,
transient修饰符不继承;子类要自己加
JSON 库里 transient 为什么经常失效
Jackson 默认忽略 transient 字段,但 Fastjson 1.x 默认**不忽略**,2.x 才默认遵循。Gson 则完全无视 transient,只看字段可见性(public 或有 getter)。
使用场景:你写了 private String password; 并加了 transient,结果用 new ObjectMapper().writeValueAsString(user) 还是输出了 "password":"123"——这就是 Jackson 默认行为没被触发的典型信号。
立即学习“Java免费学习笔记(深入)”;
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- Jackson 要启用
transient忽略,得显式配置:mapper.configure(SerializationFeature.WRITE_TRANSIENT_FIELDS, false) - 更稳妥的做法是统一用注解:
@JsonIgnore(Jackson)、@JSONField(serialize = false)(Fastjson)、@Expose(serialize = false)(Gson) - 别依赖
transient去防 JSON 泄露,它不是为这个设计的
transient 和 serialVersionUID 的配合要点
加 transient 不影响 serialVersionUID 计算——JVM 生成默认 UID 时本来就排除 transient 和 static 字段。但如果你手写了 serialVersionUID,后续删字段、加 transient 都不会导致反序列化失败。
容易踩的坑:改了字段为 transient 后没更新 serialVersionUID,看起来没问题,但一旦服务端和客户端版本不一致,旧客户端可能因字段缺失直接报 InvalidClassException。
- 只要类结构变动(增删非-transient 字段、改类型),就该重新计算并更新
serialVersionUID - IDE 自动生成的 UID 是基于当前所有非-static 非-transient 字段签名的,所以加
transient后再自动生成,值通常不变 - 线上系统建议始终显式声明
serialVersionUID,避免 JVM 自动计算带来的不确定性
替代方案比死守 transient 更可靠
真正需要防敏感字段泄露的场景(比如用户对象传网络、落日志),靠 transient 太单薄。它只管 Java 原生序列化,而现实中更多是 JSON、数据库 ORM、日志打印、调试 toString()。
性能上没差异,但它解决的是非常窄的问题边界:仅限 ObjectOutputStream → ObjectInputStream 这一条链路。
- DTO 分层:把入参/出参对象和领域模型分开,敏感字段根本不出现在 DTO 里
- 日志脱敏:用
@ToString.Exclude(Lombok)或自定义toString(),别依赖transient - 序列化定制:实现
writeObject()/readObject(),能精确控制每个字段行为,比transient灵活得多
复杂点在于:没有银弹。一个字段是否“敏感”,取决于它出现在哪个上下文——网络响应要藏,数据库备份可能要留,审计日志又要记操作人而非密码明文。得按场景拆开处理,而不是指望一个关键字兜底。

















