java自定义异常必须提供四个基础构造方法：无参、仅message、message+cause、仅cause；需声明不可变业务字段并提供对应构造，且显式定义serialversionuid。
在 Java 中为自定义异常类定义多个构造方法，核心是**复用父类（Exception 或 RuntimeException）的构造能力**，同时按需补充业务字段和语义清晰的初始化入口。这不是可选项，而是最佳实践——缺少关键构造方法会导致 getMessage() 返回 null、无法构建异常链、或难以统一注入错误码等信息。
必须提供的四个基础构造方法
无论继承 Exception 还是 RuntimeException，都应至少提供以下四种构造方法，覆盖常见使用场景：
-
无参构造：用于快速抛出默认提示，内部调用
super("默认消息")或留空由子类/调用方决定 -
仅传 message 的构造：最常用，确保
getMessage()可靠返回非空字符串，必须调用super(message) -
传 message 和 cause 的构造：支持异常链（如包装底层 IOException），必须调用
super(message, cause) -
仅传 cause 的构造：当只想保留原始异常堆栈但换一个语义层级时使用，调用
super(cause)
带业务字段时的构造方法设计
如果异常需携带错误码、用户 ID、订单号等上下文，不要只靠拼接 message。推荐做法是：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 声明
private final String errorCode;等不可变字段 - 提供
BizException(String errorCode, String message)构造，强制传入错误码 - 在该构造中调用
super("[" + errorCode + "] " + message)，保证 message 可读且结构化 - 同时提供
BizException(String errorCode, String message, Throwable cause)版本，支持链式封装
别忘了 serialVersionUID
如果异常类可能被序列化（如远程调用、日志落盘、分布式链路追踪），必须显式定义 serialVersionUID。否则 JVM 会自动生成，不同编译环境结果不一致，反序列化时会抛 InvalidClassException。
例如：
private static final long serialVersionUID = -7034897190745766939L;（可直接复制 RuntimeException 的值，或用 IDE 自动生成）
实际代码示例
一个兼顾健壮性与业务表达力的自定义异常：
public class InsufficientStockException extends RuntimeException {
private static final long serialVersionUID = -7034897190745766939L;
private final String skuCode;
private final int requestedQty;
private final int availableQty;
public InsufficientStockException(String skuCode, int requestedQty, int availableQty) {
super(String.format("库存不足：商品[%s]请求%d件，仅剩%d件", skuCode, requestedQty, availableQty));
this.skuCode = skuCode;
this.requestedQty = requestedQty;
this.availableQty = availableQty;
}
// 支持异常链的完整构造
public InsufficientStockException(String skuCode, int requestedQty, int availableQty, Throwable cause) {
super(String.format("库存不足：商品[%s]请求%d件，仅剩%d件", skuCode, requestedQty, availableQty), cause);
this.skuCode = skuCode;
this.requestedQty = requestedQty;
this.availableQty = availableQty;
}
// getter 方法省略，实际项目中建议补全
}Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
