如何正确定义自定义异常？继承RuntimeException和Exception的关键选择依据是什么？-java教程-PHP中文网

如何正确定义自定义异常？继承RuntimeException和Exception的关键选择依据是什么？

看不見的法師

发布： 2025-06-29 19:29:05

原创

955人浏览过

自定义异常的核心在于根据异常是否需要强制处理来选择继承runtimeexception或exception。继承runtimeexception适用于程序逻辑错误，如参数校验失败，无需强制处理，编译器不检查；继承exception适用于外部因素导致的错误，如文件不存在，必须try-catch或throws声明。创建自定义异常需定义类并添加属性方法，如mycustomexception含errorcode，mycustomruntimeexception含detailmessage。抛出时dosomething需声明throws，而dosomethingelse无需声明。处理时分别捕获并输出信息。避免滥用自定义异常，优先使用标准异常类，仅在必要时扩展。多线程中可用uncaughtexceptionhandler或future.get()处理异常。spring boot中可结合@controlleradvice、@exceptionhandler、errorattributes及responseentityexceptionhandler实现全局异常管理。

如何正确定义自定义异常？继承RuntimeException和Exception的关键选择依据是什么？

定义自定义异常，说白了就是为了更精准地处理程序中可能出现的各种“意外”。至于继承 RuntimeException 还是 Exception，这可不是随便选的，背后藏着不少门道。简单来说，RuntimeException 是非受检异常，编译器不会强制你必须处理；而 Exception 是受检异常，不 try-catch 或者 throws 声明，编译器就跟你过不去。

解决方案

自定义异常，核心在于创建一个新的类，继承自 Exception 或者 RuntimeException，然后根据你的需求添加一些自定义的属性和方法。

创建自定义异常类

// 继承 Exception（受检异常）
class MyCustomException extends Exception {
    private int errorCode;

    public MyCustomException(String message, int errorCode) {
        super(message);
        this.errorCode = errorCode;
    }

    public int getErrorCode() {
        return errorCode;
    }
}

// 继承 RuntimeException（非受检异常）
class MyCustomRuntimeException extends RuntimeException {
    private String detailMessage;

    public MyCustomRuntimeException(String message, String detailMessage) {
        super(message);
        this.detailMessage = detailMessage;
    }

    public String getDetailMessage() {
        return detailMessage;
    }
}

登录后复制

抛出自定义异常

public void doSomething(int value) throws MyCustomException { // 必须声明 throws
    if (value < 0) {
        throw new MyCustomException("Value cannot be negative", 1001);
    }
    // ...
}

public void doSomethingElse(String input) { // 无需声明 throws
    if (input == null || input.isEmpty()) {
        throw new MyCustomRuntimeException("Input cannot be null or empty", "Invalid input received");
    }
    // ...
}

登录后复制

处理自定义异常

通义视频

通义万相AI视频生成工具

查看详情

try {
    doSomething(-1);
} catch (MyCustomException e) {
    System.err.println("Caught MyCustomException: " + e.getMessage() + ", Error Code: " + e.getErrorCode());
}

try {
    doSomethingElse(null);
} catch (MyCustomRuntimeException e) {
    System.err.println("Caught MyCustomRuntimeException: " + e.getMessage() + ", Detail: " + e.getDetailMessage());
}

登录后复制

什么时候该选择继承 `RuntimeException`？

考虑一下这样的场景：一个方法被调用了无数次，每次调用都强制进行异常处理会显得非常繁琐，甚至影响代码的可读性。比如，空指针异常 NullPointerException，你总不能每次用到对象都 try-catch 一下吧？继承 RuntimeException 的异常通常表示程序逻辑错误，这种错误应该在开发阶段就避免，而不是在运行时依赖异常处理。

场景举例: 参数校验失败，比如传入的参数明显不符合业务规则，这种错误更应该在代码层面避免。
适用情况: 你认为这种异常的发生是不可避免的，或者处理起来成本太高，不如让程序直接崩溃，然后修复 bug。

什么时候该选择继承 `Exception`？

如果你的异常是由于外部因素导致的，比如网络连接中断、文件不存在等，这些情况是程序无法完全控制的，那么就应该继承 Exception。强制要求调用者处理这些异常，可以提高程序的健壮性。

场景举例: 读取配置文件时，文件不存在，这种情况是程序无法保证的。
适用情况: 你希望调用者能够明确地知道这个方法可能会抛出异常，并且强制他们进行处理，避免程序在运行时出现未知的错误。

如何避免过度使用自定义异常？

自定义异常虽然强大，但也不能滥用。过多的异常定义会让代码变得复杂，难以维护。

考虑使用现有的异常类: Java 已经提供了很多标准的异常类，比如 IllegalArgumentException、IOException 等，如果你的异常可以用这些类来表示，就尽量不要自定义。
只在必要的时候自定义异常: 只有当你需要添加额外的属性或者方法来描述异常信息时，才考虑自定义异常。
保持异常的层次结构清晰: 如果你的应用有很多自定义异常，可以考虑使用继承来组织它们，保持代码的结构清晰。

如何在多线程环境中使用自定义异常？

在多线程环境中，异常的处理会更加复杂。你需要确保每个线程都能正确地处理异常，避免程序崩溃。

使用 Thread.UncaughtExceptionHandler: 可以为每个线程设置一个 UncaughtExceptionHandler，用于处理线程中未捕获的异常。
使用 Future 获取异常: 如果你的线程是通过 ExecutorService 提交的，可以使用 Future 的 get() 方法来获取线程执行过程中抛出的异常。
避免在线程之间传递异常: 尽量避免在不同的线程之间传递异常，这会导致代码的复杂度增加。

如何在 Spring Boot 中使用自定义异常？

Spring Boot 提供了强大的异常处理机制，可以让你轻松地处理自定义异常。

使用 @ControllerAdvice 和 @ExceptionHandler: 可以创建一个全局的异常处理类，使用 @ControllerAdvice 和 @ExceptionHandler 注解来处理不同类型的异常。
自定义 ErrorAttributes: 可以自定义 ErrorAttributes 来添加额外的异常信息到响应中。
使用 ResponseEntityExceptionHandler: 可以继承 ResponseEntityExceptionHandler 来定制 Spring MVC 的异常处理行为。