Java自定义异常需实现Serializable、显式声明serialVersionUID，并确保code/msg/traceId等字段非transient且类型可序列化；反序列化时需校验字段合法性，防止状态丢失或非法。
Java中自定义异常要保证在序列化与反序列化后仍完整保留错误码（如code）、错误消息（msg）及业务上下文（如traceId、params等），关键不是“能序列化”，而是“不丢字段、不错类型、不破语义”。核心在于三点：实现Serializable、显式声明serialVersionUID、避免敏感字段被忽略或默认处理破坏结构。
必须实现 Serializable 并固定 serialVersionUID
自定义异常类必须直接实现 java.io.Serializable 接口，不能仅靠继承父类（如RuntimeException）间接满足——因为父类本身未实现该接口。同时，必须显式定义 private static final long serialVersionUID，否则类结构稍作修改（如增减字段、改访问修饰符）就会导致反序列化失败（InvalidClassException）。
- 错误码字段（如
private final int code）、消息字段（private final String msg）应设为final或至少非 transient - 上下文字段（如
private String traceId、private Map<String, Object> context）同样需确保可序列化，且其类型本身也得实现Serializable（例如HashMap可，但ThreadLocal不可）
避免使用 transient，慎用默认序列化逻辑
如果异常中包含临时状态、不可序列化对象（如 Socket、Connection），可用 transient 修饰——但错误码和上下文字段绝不能加 transient，否则反序列化后这些值会变成默认值（0、null），彻底丢失业务信息。
若确实需要控制序列化行为（比如对敏感字段加密存储、或兼容旧版本字段），应重写 private void writeObject(ObjectOutputStream out) 和 private void readObject(ObjectInputStream in)：
立即学习“Java免费学习笔记（深入）”；
- 先调用
out.defaultWriteObject()/in.defaultReadObject()保底处理所有非 transient 字段 - 再手动 write/read 额外字段（如加密后的 password、base64 编码的 stackTrace）
- 注意：这两个方法是 private 的，不参与继承链，子类需自行重写
保持构造逻辑与反序列化一致性
Java 反序列化会绕过构造方法，直接创建对象并填充字段。因此，异常类必须提供无参构造器（哪怕只是 protected 或 private），否则某些序列化框架（如 RMI、部分 RPC）可能失败。
更稳妥的做法是：让所有关键字段都通过字段赋值初始化，并在 readObject 中做必要校验：
- 例如检查
code < 0时抛InvalidObjectException，防止反序列化出非法状态 - 若上下文字段含不可空属性（如
traceId），可在readObject中补默认值或抛异常提醒
实际示例：带错误码与 traceId 的异常类
以下是一个典型安全设计：
public class BizException extends RuntimeException implements Serializable {
private static final long serialVersionUID = -1234567890123456789L;
private final int code;
private final String msg;
private final String traceId;
private final Map<String, Object> params;
public BizException(int code, String msg) {
this(code, msg, null, null);
}
public BizException(int code, String msg, String traceId, Map<String, Object> params) {
super(msg); // 保证 getMessage() 正常
this.code = code;
this.msg = msg;
this.traceId = traceId;
this.params = params != null ? new HashMap<>(params) : Collections.emptyMap();
}
// getter 省略...
private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException {
in.defaultReadObject();
// 补充校验
if (this.code < 100 || this.code > 999) {
throw new InvalidObjectException("Invalid error code: " + this.code);
}
}
}
这样序列化后，远程服务收到的异常仍能准确提取 getCode()、getTraceId()，用于日志追踪与前端提示，不会变成空壳 RuntimeException。
