自定义异常类必须继承Exception或RuntimeException；继承Exception需强制处理，继承RuntimeException则无需声明；推荐命名以Exception结尾，提供带String参数的构造函数及业务字段getter。
自定义异常类必须继承 Exception 或 RuntimeException
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-2024-789");
}
balance -= amount;
}
捕获自定义异常和捕获普通异常没有语法区别
捕获自定义异常的写法和捕获 IOException 或 NullPointerException 完全一样，关键在于 catch 的类型是否匹配。只要异常对象是该类或其子类实例，就能被捕获。
立即学习“Java免费学习笔记（深入）”；
- 可以单独捕获特定自定义异常，做精细化处理（如记录订单号、触发补偿流程）
- 也可以用多个
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，而是判断什么时候该用自定义异常、什么时候该用返回值、什么时候该熔断 —— 这些取决于你的服务边界和协作契约。别为了“规范”而堆砌异常类。
