Java中如何应用序列化 serialVersionUID 版本号呢？

为了更好地理解 serialVersionUID 的使用，下面通过一个简单的 Java 示例来说明如何为类定义 serialVersionUID，并演示版本不匹配时可能出现的问题。

示例1：没有 serialVersionUID 的类

首先，创建一个没有 serialVersionUID 的类，模拟序列化和反序列化的过程。

import java.io.*;class Person implements Serializable {private String name;private int age;public Person(String name, int age) {this.name = name;this.age = age;}@Overridepublic String toString() {return "Person{name='" + name + "', age=" + age + '}';}
}public class SerializeDemo {public static void main(String[] args) {Person person = new Person("Alice", 30);// 序列化对象到文件try (ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream("person.ser"))) {oos.writeObject(person);System.out.println("序列化成功：" + person);} catch (IOException e) {e.printStackTrace();}// 反序列化对象从文件try (ObjectInputStream ois = new ObjectInputStream(new FileInputStream("person.ser"))) {Person deserializedPerson = (Person) ois.readObject();System.out.println("反序列化成功：" + deserializedPerson);} catch (IOException | ClassNotFoundException e) {e.printStackTrace();}}
}

输出结果：

序列化成功：Person{name='Alice', age=30}
反序列化成功：Person{name='Alice', age=30}

示例2：类修改后未定义 serialVersionUID

现在我们对 Person 类进行修改，增加一个新的字段 email，但不显式定义 serialVersionUID，然后尝试反序列化旧对象。

class Person implements Serializable {private String name;private int age;private String email;  // 新增字段public Person(String name, int age, String email) {this.name = name;this.age = age;this.email = email;}@Overridepublic String toString() {return "Person{name='" + name + "', age=" + age + ", email='" + email + "'}";}
}

可能出现的问题：

当你尝试使用这个修改后的类去反序列化之前的对象时，可能会抛出 InvalidClassException，因为类的结构发生了变化，JVM会为每个类自动生成不同的serialVersionUID。

Exception in thread "main" java.io.InvalidClassException: Person; local class incompatible: 
stream classdesc serialVersionUID = -1234567890, local class serialVersionUID = 1234567890

示例3：显式定义 serialVersionUID

为了避免上述问题，我们可以为 Person 类显式定义一个固定的 serialVersionUID。这可以确保即使类发生了小的修改（比如添加新字段），我们仍然可以成功反序列化旧对象。

class Person implements Serializable {private static final long serialVersionUID = 1L;  // 手动定义serialVersionUIDprivate String name;private int age;private String email;  // 新增字段public Person(String name, int age, String email) {this.name = name;this.age = age;this.email = email;}@Overridepublic String toString() {return "Person{name='" + name + "', age=" + age + ", email='" + email + "'}";}
}

总结

通过显式定义 serialVersionUID，我们可以：

1. 确保版本兼容性：在类的结构发生小的变化时，仍然可以反序列化旧版本的对象。
2. 避免异常：避免出现由于 JVM 自动生成的不同 serialVersionUID 导致的 InvalidClassException。

最佳实践

• 始终手动定义 serialVersionUID，确保类版本之间的兼容性。
• 在类结构发生重大变化时（如删除字段或改变字段类型），更新 serialVersionUID 以确保版本控制。

通过这种方式，你可以避免序列化和反序列化过程中出现的潜在问题。

推荐阅读文章

• 由 Spring 静态注入引发的一个线上T0级别事故（真的以后得避坑）
• 如何理解 HTTP 是无状态的，以及它与 Cookie 和 Session 之间的联系
• HTTP、HTTPS、Cookie 和 Session 之间的关系
• 什么是 Cookie？简单介绍与使用方法
• 什么是 Session？如何应用？
• 使用 Spring 框架构建 MVC 应用程序：初学者教程
• 有缺陷的 Java 代码：Java 开发人员最常犯的 10 大错误
• 如何理解应用 Java 多线程与并发编程？
• 把握Java泛型的艺术：协变、逆变与不可变性一网打尽
• Java Spring 中常用的 @PostConstruct 注解使用总结
• 如何理解线程安全这个概念？
• 理解 Java 桥接方法
• Spring 整合嵌入式 Tomcat 容器
• Tomcat 如何加载 SpringMVC 组件
• “在什么情况下类需要实现 Serializable，什么情况下又不需要（一）？”
• “避免序列化灾难：掌握实现 Serializable 的真相！（二）”
• 如何自定义一个自己的 Spring Boot Starter 组件（从入门到实践）
• 解密 Redis：如何通过 IO 多路复用征服高并发挑战！
• 线程 vs 虚拟线程：深入理解及区别
• 深度解读 JDK 8、JDK 11、JDK 17 和 JDK 21 的区别
• 10大程序员提升代码优雅度的必杀技，瞬间让你成为团队宠儿！
• “打破重复代码的魔咒：使用 Function 接口在 Java 8 中实现优雅重构！”
• Java 中消除 If-else 技巧总结
• 线程池的核心参数配置(仅供参考)
• 【人工智能】聊聊Transformer，深度学习的一股清流(13)
• Java 枚举的几个常用技巧，你可以试着用用