1 / 4概念
Error
Java 用异常对象表达失败,用 throws 把可恢复的失败写进签名,用 try-with-resources 保证资源释放。真正的难点不是语法,而是判断在哪一层把「技术异常」转换成「领域错误」。
1 概念
1.1 一句话定义
异常是 Throwable 的实例,throw 把它抛入调用栈,try/catch/finally 负责捕获与清理,throws 在签名上声明受检异常;实现了 AutoCloseable 的资源由 try-with-resources 按逆序关闭。
1.2 它解决什么问题
- 分离正常与失败路径:返回值只表达成功,失败走独立通道,调用方不必层层判断错误码。
- 强制处理可恢复错误:受检异常让编译器要求调用方捕获或继续声明,失败不会被忽略。
- 保留因果链:
cause把底层异常串起来,排障时能一路看到根因。 - 不丢失清理期失败:关闭资源时的异常通过 suppressed 附加到主异常上,而不是覆盖它。
没有这层纪律,失败会被空 catch 吞掉,资源会泄漏,日志里只剩一句没有上下文的「出错了」。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
HTTP 状态码、ProblemDetail 与全局异常处理 | Spring Boot |
| 日志采集、追踪与告警规则 | Observability |
| 中断、超时与线程池拒绝策略 | Concurrency Models |
| 用返回值或密封类型建模失败 | OOP |
| 异常表的字节码结构与栈帧布局 | JVM Runtime |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 受检异常 | Exception 的子类,除 RuntimeException 外 | 编译期强制处理,不进入方法描述符 |
| 错误 | Error 及其子类 | 表示 JVM 级问题,通常不该捕获 |
| 异常链 | cause 形成的因果链 | 不是 suppressed |
| 抑制异常 | 关闭资源时产生的次要异常 | 用 getSuppressed() 读取 |
| try-with-resources | 自动关闭 AutoCloseable 的语法 | 关闭顺序与声明顺序相反 |
| 非受检异常 | RuntimeException 及其子类 | 编译器不强制,但不代表可以忽略 |
2 机制
2.1 心智模型
异常沿调用栈向上找第一个匹配的处理器。 每个方法调用帧都带一张异常表:抛出时 JVM 逐帧查找覆盖当前指令的处理条目,匹配就跳转过去,不匹配就弹出栈帧继续找;走到栈底还没找到,就交给线程的未捕获异常处理器,线程终止。finally 和 try-with-resources 只是在每条出口上插入了清理代码。
2.2 机制拆解
- 抛出:
new创建异常对象并填充栈;构造器签名可以传writableStackTrace=false省掉填栈成本。 - 传播:JVM 查异常表,命中则转到 handler,未命中则继续向上;跨越
synchronized时会释放监视器。 - 捕获:按
catch声明顺序匹配,子类必须写在父类之前;多重捕获的参数是隐式final。 - 清理:
finally在正常返回、异常抛出、break/continue时都会执行,但被System.exit或 JVM 崩溃跳过。 - 资源关闭:try-with-resources 编译成嵌套的
try/finally,按声明逆序调用close()。 - 抑制:主体抛异常且
close()也抛异常时,close()的异常被addSuppressed到主异常,主异常继续传播。
2.3 完整枚举
Throwable 的层级是封闭的,业务异常都挂在这棵树上:
| 类别 | 代表类型 | 是否受检 | 处理策略 |
|---|---|---|---|
Error | OutOfMemoryError、StackOverflowError | 否 | 不捕获,交给进程退出或外层守护 |
Error | LinkageError、NoClassDefFoundError | 否 | 修依赖与类路径,不要重试 |
RuntimeException | NullPointerException、ClassCastException | 否 | 修代码,加边界校验 |
RuntimeException | IllegalArgumentException、IllegalStateException | 否 | 参数与状态校验,映射为 4xx |
Exception | IOException、SQLException | 是 | 捕获、重试或在边界转换 |
Exception | InterruptedException | 是 | 恢复中断标志或继续抛出 |
| 自定义 | 继承 RuntimeException 的领域异常 | 否 | 携带错误码与上下文,边界统一映射 |
处理原语也有限:
| 原语 | 作用 | 注意 |
|---|---|---|
throw | 抛出一个异常实例 | 不要复用同一个异常实例,栈会错 |
throws | 声明受检异常 | 签名即契约,改动会影响调用方 |
catch | 按类型捕获 | 子类在前,避免宽类型吞掉具体类型 |
finally | 无条件清理 | 不要在 finally 里 return 或抛异常 |
| try-with-resources | 自动关闭资源 | 资源变量在 Java 9 起可引用 effectively final 变量 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 构造异常并填栈 | 1–10 µs | 栈越深越贵;高频路径要避免 |
| 默认栈深度 | 10^3–10^4 帧 | 1 MB 线程栈,递归过深抛 StackOverflowError |
| 受检异常检查 | 编译期一次 | 不进入方法描述符,反射不可见 |
| try-with-resources | Java 7 起 | Java 9 起支持 effectively final 变量 |
| 抑制异常 | 每个关闭失败 1 条 | 无固定上限,链式资源会累积 |
| 默认回滚规则 | RuntimeException 与 Error | 受检异常默认不回滚,需显式声明 |
| 异常日志字段 | 类型、消息、cause、suppressed | 少一项都会让排障变慢 |
3 实践
3.1 最小示例
下面这段代码同时演示资源自动关闭、领域异常包装与抑制异常:
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
public final class ErrorDemo {
static final class DomainException extends RuntimeException {
DomainException(String message, Throwable cause) { super(message, cause); }
}
static final class FailingResource implements AutoCloseable {
private final String name;
FailingResource(String name) { this.name = name; }
void use() { throw new IllegalStateException("use " + name); }
@Override public void close() throws Exception {
throw new IOException("close " + name);
}
}
static List<String> readLines(Path path) {
try (var reader = Files.newBufferedReader(path)) {
return reader.lines().toList();
} catch (IOException e) {
throw new DomainException("read failed: " + path, e);
}
}
public static void main(String[] args) throws Exception {
Path file = Files.createTempFile("error-demo", ".txt");
Files.writeString(file, "alpha\nbeta\n");
System.out.println(readLines(file));
Files.delete(file);
try (var resource = new FailingResource("db")) {
resource.use();
} catch (Exception e) {
System.out.println("caught=" + e.getMessage());
for (Throwable suppressed : e.getSuppressed()) {
System.out.println("suppressed=" + suppressed.getMessage());
}
}
}
}
java ErrorDemo.java 运行。第二段输出 caught=use db 加 suppressed=close db:主体抛出的 IllegalStateException 是主异常,close() 的 IOException 被抑制而不是覆盖。第一段走的是成功路径,但 readLines 已把失败分支写死:读取抛 IOException 时包成 DomainException 并保留 cause。
把 try (var reader = ...) 换成手动 close(),异常路径上的 close 就会被跳过;把 catch (IOException e) 换成 catch (Exception e),NullPointerException 也会被当成领域错误吞掉。
3.2 常用操作与参数
| 目的 | 写法 | 说明 |
|---|---|---|
| 声明可恢复失败 | throws IOException | 调用方必须捕获或继续声明 |
| 抛领域错误 | throw new OrderRejected(id, reason) | 带上下文,不暴露内部实现 |
| 多重捕获 | catch 后并列多个异常类型(竖线分隔) | 处理逻辑相同才合并 |
| 自动关闭 | try (var in = Files.newInputStream(p)) | 多个资源按声明逆序关闭 |
| 保留根因 | new DomainException(msg, e) | 不要只传 e.getMessage() |
| 附加清理异常 | e.addSuppressed(closeError) | 手写 finally 时使用 |
| 边界映射 | @ExceptionHandler 加错误码 | 内部异常只进日志,不回显 |
3.3 标准流程
- 先定义领域异常层级:一个基类携带错误码,子类表达具体失败,避免几十个平行异常。
- 在基础设施边界捕获技术异常,转换成领域异常并保留 cause。
- 所有资源用 try-with-resources;手写
finally时把关闭异常addSuppressed。 - 只在最外层记录日志并映射协议错误,内层不重复打印。
- 为每条异常路径写测试:缺文件、超时、非法参数、资源关闭失败。
3.4 与相邻技术的组合
- Spring MVC:
@ControllerAdvice加ProblemDetail把领域异常映射成 RFC 7807 响应,栈只进日志。 - 事务:默认只对
RuntimeException与Error回滚;受检异常需rollbackFor显式声明。 - 日志与追踪:异常对象作为日志参数传入,MDC 里的 traceId 把跨服务调用串起来。
- 重试:只重试幂等且可恢复的异常,
InterruptedException不能盲目重试。
3.5 选型维度
| 维度 | 受检异常 | 非受检异常 | 返回值结果 | 错误码 |
|---|---|---|---|---|
| 编译期强制 | 是 | 否 | 否 | 否 |
| 与函数式接口兼容 | 差 | 好 | 好 | 好 |
| 调用方负担 | 高 | 低 | 中 | 中 |
| 适合边界 | 库、IO | 业务、框架 | 领域服务 | 跨进程协议 |
| 上下文携带 | 异常对象 | 异常对象 | 结果对象 | 枚举加详情 |
3.6 决策规则
- 调用方确实能恢复(重试、降级、换路径)时,用受检异常;否则用非受检。
- 编程错误(空值、越界、状态错乱)一律用非受检异常,不要逼调用方
catch。 - 领域层用非受检的领域异常,边界统一映射成协议错误。
- 高频、可预期的失败(限流、缓存未命中)用返回值或
Optional,不要用异常。 - 包装异常必须保留 cause,禁止只保留 message。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 受检异常 | 编译器强制处理 | 污染签名,lambda 里难用 | IO、库 API |
| 非受检异常 | 签名干净,组合友好 | 容易被忽略 | 业务与框架 |
Result / Either | 失败是值,可组合 | 需要自建类型,样板多 | 领域服务、函数式风格 |
| 错误码枚举 | 跨进程稳定 | 丢失栈与因果 | HTTP、gRPC 协议 |
3.8 何时不该用
- 不要用异常做循环控制或正常分支,栈填充成本会拖垮热路径。
- 不要在
finally里return或抛新异常,它会覆盖原始失败。 - 不要捕获
Error后继续执行业务逻辑,JVM 状态可能已经不可信。 - 不要把
InterruptedException吞掉,必须恢复中断标志或继续抛出。 - 不要让受检异常出现在公开 API 的每个方法上,调用方会被迫写无意义的
throws。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 失败被静默忽略 | catch 块为空或只打日志不重抛 | 至少记录并重抛,或返回明确失败 |
| 日志里只有「出错了」 | 包装时丢掉了 cause | 构造器传入原始异常,打印完整链 |
| 原始异常消失 | finally 里又抛了异常 | 用 try-with-resources 或 addSuppressed |
| 资源句柄泄漏 | 手动 close 漏掉异常路径 | 全部改为 try-with-resources |
| 事务没回滚 | 抛出的是受检异常 | 声明 rollbackFor 或改用非受检异常 |
| 高频异常拖慢吞吐 | 用异常表达正常分支 | 改为返回值判断 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
空 catch | 失败无声,问题延后爆发 | 记录并重抛或明确降级 |
catch (Exception e) 一把抓 | 编程错误被当成业务失败 | 按类型捕获,最外层兜底 |
| 用异常控制流程 | 栈填充开销高,语义混乱 | 条件判断或 Optional |
4.3 可观测信号
- 异常率:按类型统计的每秒抛出数、各接口的错误率、领域异常与系统异常的比例。
- 异常内容:日志里的
Caused by链深度、suppressed 数量、错误码分布。 - 运行时:JFR 的
jdk.JavaExceptionThrow与jdk.JavaErrorThrow事件、线程 dump 中的阻塞点。 - 协议层:4xx 与 5xx 的比例、同一错误码的突增,通常是上游变更的第一信号。
4.4 安全 / 性能 / 一致性边界
- 安全边界:异常消息与栈会泄漏表名、路径、内部 IP;对外响应只给错误码与通用描述,细节只进受控日志。
- 性能边界:异常在抛出时才付费,但高频抛出会把微秒级成本放大成吞吐问题;关闭填栈会牺牲排障能力。
- 一致性边界:事务回滚规则、重试语义、幂等键必须与异常类型对齐;受检异常默认不回滚是最常见的隐性不一致。