为什么你应该手动定义 serialVersionUID？@Serial 注解有什么作用？

最近在优化一个Java项目时，遇到了一个关于类序列化的问题。项目中有一个需要实现 Serializable 接口的类，我发现有一段代码使用了 @Serial 注解，并且还定义了 serialVersionUID，具体如下：

@Serial
private static final long serialVersionUID = 5652464866930818765L;

看到这种写法后，我开始思考两个问题：@Serial 注解的作用是什么？以及在类实现序列化时，是否必须手动定义 serialVersionUID？同时，我也想知道能否通过 Lombok 来简化这种配置，因为 Lombok 可以为类提供许多便捷的自动生成特性。

什么是 @Serial 注解？

@Serial 注解是 JDK 14 引入的，它的主要作用是标识与序列化相关的字段或方法，特别是用于标识 serialVersionUID、readObject、writeObject、readResolve 和 writeReplace 等序列化特殊方法。它并不是强制性的，但它提供了一种更具可读性和语义化的方式来标注序列化代码。

例如：

@Serial
private static final long serialVersionUID = 5652464866930818765L;

这段代码使用 @Serial 来明确表示 serialVersionUID 是与 Java 序列化机制相关的字段。尽管不加这个注解，代码仍然能够正常工作，但加上它可以帮助开发者更直观地理解这些字段和方法的用途，特别是在使用 JDK 14 及更高版本时。

serialVersionUID 的作用

serialVersionUID 是 Java 序列化机制中用于版本控制的一个字段。它确保同一个类在不同版本间可以安全地进行序列化和反序列化。具体来说，serialVersionUID 允许你控制类的不同版本之间的兼容性。

• 序列化：在序列化时，Java 会将对象的 serialVersionUID 与数据一起保存到文件中。
• 反序列化：在反序列化时，Java 会检查当前类的 serialVersionUID 是否与序列化时的 serialVersionUID 相匹配。如果不匹配，Java 会抛出 InvalidClassException，提示类不兼容。

配置 serialVersionUID 是否必要？

如果你没有手动定义 serialVersionUID，Java 编译器会根据类的结构（字段、方法等）自动生成一个版本号。然而，自动生成的 serialVersionUID 可能在类的某些小变动（如增加字段）后发生改变，从而导致序列化和反序列化不兼容。因此，建议在需要序列化的类中显式定义 serialVersionUID，以确保类的版本控制可预期。

例如：

@Serial
private static final long serialVersionUID = 1L;

定义 serialVersionUID 的好处在于：即使你对类进行了一些轻微的修改，只要这些修改不影响序列化机制，仍然可以确保兼容性。

如果你对类做了修改（如增加字段），并且希望新旧版本仍能序列化和反序列化，你可以保持 serialVersionUID 不变。

Lombok 能简化 serialVersionUID 的配置吗？

Lombok 是一个非常流行的 Java 库，它可以通过注解来简化代码，比如 @Getter、@Setter、@Data 等。不过，Lombok 并没有提供与 serialVersionUID 相关的注解。这意味着如果你希望在类中定义 serialVersionUID，仍然需要手动配置。

例如，使用 Lombok 定义一个 Serializable 类时，依然需要手动添加 serialVersionUID：

import lombok.Data;
import java.io.Serializable;

@Data
public class User implements Serializable {
    @Serial
    private static final long serialVersionUID = 123456789L;

    private String name;
    private String email;
}

尽管 Lombok 在很多方面为我们提供了便捷，但在 serialVersionUID 的配置上并没有自动化支持。