Java Academy · 课时

transient 字段与 serialVersionUID

Q: 「transient 字段与 serialVersionUID」这节课中我会学到什么？

使用 transient 排除敏感字段，并通过 serialVersionUID 维护版本兼容性 你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 transient 排除敏感字段，并通过 serialVersionUID 维护版本兼容性

transient 字段与 serialVersionUID 是 CoddyKit 上的免费 Java Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Java Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。

为什么使用 transient？

有些字段不应被保存：密码、打开的文件句柄以及缓存的计算结果。将它们标记为 transient，序列化时就会跳过这些字段。

public class Session implements Serializable {
    private String username;
    private transient String password;   // NOT serialized
    private transient Connection dbConn; // NOT serialized
}

反序列化后的 transient 字段值

反序列化后，transient 字段会获得 Java 的默认值：对象为 null，数字为 0，布尔值为 false。

Session s = (Session) ois.readObject();
System.out.println(s.username);  // "alice"
System.out.println(s.password);  // null  (transient)

什么是 serialVersionUID？

serialVersionUID 是一个充当版本标记的 long 常量。如果类发生更改，且 UID 与文件中的 UID 不匹配，反序列化会抛出 InvalidClassException。

public class User implements Serializable {
    private static final long serialVersionUID = 1L;
    private String name;
    private int age;
}

自动生成的 UID 与显式 UID

如果省略 serialVersionUID，Java 会根据类的结构生成一个 UID。任何字段更改都会静默地改变 UID，从而导致旧数据无法使用。请始终显式声明它。

import java.io.ObjectStreamClass;
long uid = ObjectStreamClass.lookup(User.class).getSerialVersionUID();
System.out.println(uid); // e.g. 3526749255685047947

版本不匹配时的 InvalidClassException

使用 UID 已更改的类读取旧序列化数据时，Java 会抛出 InvalidClassException: local class incompatible: stream classdesc serialVersionUID = X, local class serialVersionUID = Y。

安全的类演进

向可序列化类中添加新字段时，可以不更改 UID。旧流会使用新字段的默认值完成反序列化。删除或重命名字段则更加危险。

public class User implements Serializable {
    private static final long serialVersionUID = 1L;
    private String name;
    private int age;
    private String email; // Added in v2 — safe if UID unchanged
}

使用 transient 进行延迟初始化

一种常见模式是：将缓存字段或派生字段标记为 transient，然后在反序列化后使用 readResolve 或在获取器中延迟重新计算它。

public class Document implements Serializable {
    private static final long serialVersionUID = 1L;
    private String content;
    private transient int wordCount = -1;
    public int getWordCount() {
        if (wordCount == -1) wordCount = content.split("\\s+").length;
        return wordCount;
    }
}

静态字段永不序列化

static 字段属于类，而不属于实例。它们永远不会包含在序列化流中——只有实例字段会被序列化。

public class Counter implements Serializable {
    private static final long serialVersionUID = 1L;
    private static int instanceCount = 0; // NOT serialized
    private int value;
}

使用 serialver 工具

serialver JDK 工具会输出某个类的默认 serialVersionUID：serialver com.example.User。在显式添加该值之前，可以使用它获取对应的值。

Externalizable 作为替代方案

Externalizable 扩展了 Serializable，并通过 writeExternal / readExternal 提供完整控制——当您希望显式控制字段而不使用 transient 时，这很有用。

public class Config implements Externalizable {
    private String host;
    private transient String secret;
    public void writeExternal(ObjectOutput out) throws IOException {
        out.writeUTF(host);
    }
    public void readExternal(ObjectInput in) throws IOException {
        host = in.readUTF();
    }
}

最佳实践

始终声明 serialVersionUID。将密码、句柄和缓存标记为 transient。进行不兼容更改时递增 UID。记录版本历史。

快速检查

反序列化后，transient int 字段的值是什么？

回顾

使用 transient 将字段排除在序列化之外。始终声明 serialVersionUID 以控制版本管理。无论如何，静态字段都不会被序列化。

常见问题解答

「transient 字段与 serialVersionUID」课时是免费的吗？

是的 — 「transient 字段与 serialVersionUID」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Java Academy 课程的其余内容，请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。

「transient 字段与 serialVersionUID」这节课中我会学到什么？

使用 transient 排除敏感字段，并通过 serialVersionUID 维护版本兼容性你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Java Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「transient 字段与 serialVersionUID」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Java Academy 课中编写并运行代码吗？

能。每节 Java Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Java Academy