Java中自定义编译时异常需继承Exception类并提供四种标准构造方法，调用方必须显式处理；若继承RuntimeException则变为运行时异常，失去编译检查能力。
Java 中自定义编译时异常，只需让自定义类继承 Exception 类（而非 RuntimeException），并提供合适的构造方法即可。编译器会强制调用方处理该异常（通过 try-catch 或 throws 声明）。
继承 Exception 的基本写法
自定义异常类必须直接或间接继承 Exception，推荐使用标准构造方法覆盖，确保与 JDK 异常行为一致：
- 无参构造：用于简单场景，如
new InsufficientBalanceException() - 带 String 消息的构造：便于调试和日志，如
new InsufficientBalanceException("余额不足") - 带 Throwable cause 的构造：支持异常链，用于包装底层异常
- 带 message 和 cause 的构造：最完整，符合 JDK 最佳实践
完整示例代码
以下是一个典型的编译时异常实现：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
public class InsufficientBalanceException extends Exception {
// 1. 无参构造
public InsufficientBalanceException() {
super();
}
// 2. 仅带消息的构造
public InsufficientBalanceException(String message) {
super(message);
}
// 3. 仅带 cause 的构造
public InsufficientBalanceException(Throwable cause) {
super(cause);
}
// 4. 同时带 message 和 cause（推荐）
public InsufficientBalanceException(String message, Throwable cause) {
super(message, cause);
}
}
在方法中使用并触发编译检查
声明抛出该异常后，调用方必须显式处理，否则编译失败：
立即学习“Java免费学习笔记（深入）”；
- 在方法签名中用
throws InsufficientBalanceException声明 - 在方法体内用
throw new InsufficientBalanceException("...")抛出 - 调用该方法的代码必须用 try-catch 捕获，或在其方法签名中继续 throws
例如：
public void withdraw(double amount) throws InsufficientBalanceException {
if (amount > balance) {
throw new InsufficientBalanceException("取款金额 " + amount + " 超出当前余额 " + balance);
}
balance -= amount;
}
// 调用处必须处理
public void processWithdrawal() {
try {
withdraw(1000.0);
} catch (InsufficientBalanceException e) {
System.err.println("处理失败：" + e.getMessage());
}
}
注意点
- 不要继承 RuntimeException，否则变成运行时异常，失去编译检查能力
- 若需序列化（如远程调用），建议添加
private static final long serialVersionUID = 1L; - 异常类名建议以 Exception 结尾，语义清晰
- 消息内容应简洁明确，避免暴露敏感信息或内部实现细节
