在Java里如何捕获并处理自定义异常_Java自定义异常应用说明

自定义异常类必须继承Exception或RuntimeException;继承Exception需强制处理,继承RuntimeException则无需声明;推荐命名以Exception结尾,提供带String参数的构造函数及业务字段getter。

自定义异常类必须继承 ExceptionRuntimeException

Java 中抛出自定义异常的前提是定义一个类,它得是 Exception 的子类(编译期异常)或 RuntimeException 的子类(运行期异常)。不继承这两个之一,throw 时会编译失败。

区别在于:继承 Exception 的异常强制要求调用方处理(要么 try-catch,要么在方法签名加 throws);继承 RuntimeException 则无需强制声明,适合表示程序逻辑错误,比如参数非法、状态不一致等。

  • 推荐命名以 Exception 结尾,如 InsufficientBalanceException
  • 至少提供一个带 String 参数的构造函数,方便传入错误信息
  • 若需携带业务字段(如错误码、订单ID),可额外添加成员变量和对应 getter
public class InsufficientBalanceException extends RuntimeException {
    private final String orderId;

    public InsufficientBalanceException(String message, String orderId) {
        super(message);
        this.orderId = orderId;
    }

    public String getOrderId() {
        return orderId;
    }
}

抛出自定义异常要用 throw,不是 throws

throws 是写在方法声明后面的,只表示“这个方法可能会抛出某种异常”,它本身不触发异常;真正让异常发生的动作是 throw 语句。新手常混淆这两者,导致代码编译通过但逻辑没生效。

  • 检查条件后,用 throw new XxxException(...) 主动抛出
  • 如果方法内可能抛出的是继承自 Exception 的异常(非运行时),且没 try-catch,就必须在方法签名加 throws XxxException
  • 不要在 catch 块里只写 throws e; —— Java 不支持这种写法,应写 throw e;
public void withdraw(double amount) throws InsufficientBalanceException {
    if (amount > balance) {
        throw new InsufficientBalanceException("余额不足", "ORD-2025-789");
    }
    balance -= amount;
}

捕获自定义异常和捕获普通异常没有语法区别

捕获自定义异常的写法和捕获 IOExceptionNullPoin

terException 完全一样,关键在于 catch 的类型是否匹配。只要异常对象是该类或其子类实例,就能被捕获。

  • 可以单独捕获特定自定义异常,做精细化处理(如记录订单号、触发补偿流程)
  • 也可以用多个 catch 块区分不同异常类型,注意子类要在父类之前
  • 避免写成 catch (Exception e) 一锅端,会掩盖你原本想区分处理的业务语义
try {
    account.withdraw(500.0);
} catch (InsufficientBalanceException e) {
    log.warn("扣款失败,订单 {},原因:{}", e.getOrderId(), e.getMessage());
    notifyFinanceTeam(e.getOrderId());
} catch (IllegalArgumentException e) {
    log.error("参数错误:{}", e.getMessage());
}

日志和错误码比堆栈更关键

自定义异常的价值不在“抛出”本身,而在于它把业务含义编码进了类型系统。但很多团队只抛异常,却不提取关键字段打日志,结果线上出问题时只能翻堆栈找字符串,效率极低。

  • 确保每个自定义异常类都重写 toString() 或提供 toLogString() 方法,把错误码、ID、时间戳等关键上下文打包输出
  • 不要依赖 e.printStackTrace() —— 它不进日志框架,也不带 trace ID,排查时基本无用
  • 如果用了 SLF4J,优先用 logger.warn("msg", e) 形式,而不是拼接字符串 + e.getMessage()

真正难的不是写 throw,而是判断什么时候该用自定义异常、什么时候该用返回值、什么时候该熔断 —— 这些取决于你的服务边界和协作契约。别为了“规范”而堆砌异常类。