Java自定义异常类怎么创建

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《Java自定义异常类方法详解》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

必须继承Exception或RuntimeException，因JVM仅识别Throwable子类异常；继承Exception强制调用方处理，适合业务可控错误；继承RuntimeException则无需声明，适用于程序逻辑错误。

为什么必须继承 Exception 或 RuntimeException

Java 的异常体系强制要求自定义异常类必须是 Throwable 的子类，而实际开发中几乎总是选择继承 Exception（受检异常）或 RuntimeException（非受检异常）。不这样做会导致编译失败——比如直接继承 Object 写个 MyException，连 throw new MyException() 都过不了编译。

关键区别在于：继承 Exception 会让调用方**必须处理**（try/catch 或 throws），适合业务中明确需要强制干预的错误（如支付金额超限、用户未实名）；继承 RuntimeException 则无需强制声明，适合程序逻辑错误或不可恢复的意外（如参数为 null 且不该发生）。

• 不要试图绕过继承机制，用包装或代理方式模拟异常行为——JVM 不认，catch 不会捕获
• 如果想让异常既可检查又可运行时切换，得靠两个独立类，不能靠“动态继承”
• IDE 自动生成的构造函数常漏掉 cause 参数，导致嵌套异常信息丢失

super(message) 和 super(message, cause) 怎么选

绝大多数自定义异常类至少要提供带 String 参数的构造方法，否则 new MyBusinessException("余额不足") 会报错。但仅此不够——当你的异常是由另一个异常触发的（比如数据库操作失败引发业务异常），必须把原始异常作为 cause 传进去，否则堆栈里看不到底层根因。

推荐构造函数组合：

• public MyException(String message) → 调用 super(message)
• public MyException(String message, Throwable cause) → 调用 super(message, cause)
• 可选：public MyException(Throwable cause) → 调用 super(cause)，方便包装已有异常

public class InsufficientBalanceException extends Exception {
    public InsufficientBalanceException(String message) {
        super(message);
    }
    public InsufficientBalanceException(String message, Throwable cause) {
        super(message, cause);
    }
}

要不要重写 getMessage() 或 toString()

一般不用。父类 Exception 已经实现了清晰的 getMessage()（返回构造时传入的 message）和 toString()（含类名 + message）。除非你有强定制需求，比如所有业务异常必须前置固定前缀，才考虑重写：

public class OrderException extends Exception {
    public OrderException(String message) {
        super("[订单系统] " + message);
    }
    // 不建议重写 getMessage() 去拼接，容易和 cause.getMessage() 混淆
}

更安全的做法是：在日志打印时统一加前缀，而不是污染异常对象本身。重写 toString() 尤其危险——很多监控系统、序列化工具依赖它的默认格式，改了可能导致告警解析失败。

• 日志框架（如 Logback）可通过 %X{traceId} 等 MDC 字段补充上下文，比改异常更灵活
• 如果真要丰富异常信息，优先用额外字段 + getter（如 getOrderId()），而不是覆盖核心方法

序列化问题：serialVersionUID 必须显式声明吗

必须。自定义异常类默认实现 Serializable，一旦涉及远程调用（Dubbo、RMI）、缓存（Redis 存异常对象）、或集群间传递，没有显式 serialVersionUID 会导致 InvalidClassException：「local class incompatible」。

原因：JVM 自动生成的 UID 依赖类结构细节（方法签名、字段顺序等），微小改动就会变，而异常类常随业务迭代频繁修改字段（比如加个 errorCode int 字段）。

• 固定值推荐用 1L 或时间戳（如 20240501L），避免用 IDE 自动生成的长随机数
• 如果异常类确定永不序列化（如纯内存校验异常），可加 private static final long serialVersionUID = 0L; 并注释说明
• 子类必须声明自己的 serialVersionUID，不会继承父类的

public class PaymentRejectedException extends RuntimeException {
    private static final long serialVersionUID = 20240501L;
    private final String transactionId;

    public PaymentRejectedException(String message, String transactionId) {
        super(message);
        this.transactionId = transactionId;
    }

    public String getTransactionId() {
        return transactionId;
    }
}

到这里，我们也就讲完了《Java自定义异常类怎么创建》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！