自定义异常必须显式声明 private static final long serialversionuid = 1l；因其默认值易随代码微调而变，导致跨jvm反序列化失败，语义化小整数更稳定可控，且需配套实现serializable、保留关键字段可序列化、提供无参构造器。
Java 自定义异常必须显式声明 serialVersionUID，否则在跨 JVM 传输、远程调用或滚动升级时极易因类结构微调（比如加个字段、改个注释）导致反序列化失败，抛出 InvalidClassException。
为什么必须写，且不能靠 IDE 自动生成
虽然 Exception 类本身已实现 Serializable，JVM 会自动计算一个默认 serialVersionUID，但这个值依赖类名、所有字段/方法签名、访问修饰符甚至编译器细节。只要代码有轻微变动，它就变——而序列化数据（如 Dubbo 透传的异常、RocketMQ 消息头里的异常对象）一旦被旧版本序列化、新版本反序列化，就会直接中断。
- IDE 自动生成的长哈希值（如
-8923456789012345678L）本质仍是“默认策略”，不解决稳定性问题 - 推荐统一用语义化小整数，例如
1L或1001L，清晰、可控、易协作 - 只要你不做不兼容变更（如删字段、改字段类型），这个值就永远不用动
标准写法和位置
在自定义异常类中，紧随 package 和 import 之后、字段定义之前，添加一行：
private static final long serialVersionUID = 1L;
注意必须是：private、static、final、long 类型，名称严格为 serialVersionUID。
- 不要写成
public或protected—— 它只对序列化机制内部有效 - 不要漏掉
final—— 防止被意外修改 - 不要用
var或包装类（如Long）—— 必须是基本类型long
配套必须做的三件事
光写 serialVersionUID 不够，还需同步确保：
- 类明确实现
Serializable接口（不能只靠继承Exception间接满足，因为Exception虽实现了，但子类仍需显式声明可序列化意图） - 所有关键业务字段（如
code、traceId、context）不能加transient，且其类型自身也要可序列化（例如用HashMap，不用ThreadLocal） - 提供无参构造器（哪怕
private或protected），因为反序列化绕过构造方法，但某些框架（如 RMI、部分 RPC）要求该构造器存在
什么时候要升级这个值
仅当发生不兼容变更且需保留对旧序列化数据的兼容性时才改，例如：
- 删除了某个非
transient字段 - 把
int code改成了String code - 将
public方法改为private（影响反射序列化逻辑）
此时可将 1L 升为 2L 或 1002L，并同步更新所有下游模块的依赖版本，确保新旧节点加载的是同一份字节码。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
