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。推荐做法是：

• 声明 private final String errorCode; 等不可变字段
• 提供 BizException(String errorCode, String message) 构造，强制传入错误码
• 在该构造中调用 super("[" + errorCode + "] " + message)，保证 message 可读且结构化
• 同时提供 BizException(String errorCode, String message, Throwable cause) 版本，支持链式封装

别忘了 serialVersionUID

如果异常类可能被序列化（如远程调用、日志落盘、分布式链路追踪），必须显式定义 serialVersionUID。否则 JVM 会自动生成，不同编译环境结果不一致，反序列化时会抛 InvalidClassException。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

立即学习“Java免费学习笔记（深入）”；

例如：
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 方法省略，实际项目中建议补全
}