Throwable.addSuppressed() 用于将次要异常（如资源关闭失败）作为“被抑制异常”添加到主异常中，以保留原始错误上下文而不掩盖它；适用于 try-with-resources 自动抑制之外的手动场景，如清理阶段发生新异常时，需显式调用该方法并确保异常非 null 且不自引用。
在 java 中，throwable.addsuppressed() 用于将“被抑制的异常”（suppressed exceptions）显式添加到主异常中，特别适用于 try-with-resources 自动关闭资源时发生的次要错误，或你在手动处理异常过程中又抛出/捕获了其他异常，但不想掩盖原始异常的情况。
什么时候该用 addSuppressed()？
当你已经有一个主异常（比如业务逻辑失败），但在清理、回滚、日志记录、资源释放等后续操作中又发生了新异常，而你仍希望保留主异常作为“根本原因”，同时不丢弃后续异常信息时，就该用它。
- 主异常代表核心失败（如数据库写入失败）
- 次要异常发生在善后阶段（如关闭连接时网络中断、回滚事务时超时）
- 你不希望用
initCause()或构造器嵌套——因为那表示“导致关系”，而这里是“伴随发生” - 你想让调用方通过
getSuppressed()显式看到所有被抑制的异常
基本用法：手动添加被抑制异常
确保主异常是可变的（即不是 final 引用且未被冻结），然后调用 addSuppressed()：
IOException primary = new IOException("Failed to write file");
try {
// 尝试关闭资源
resource.close();
} catch (IOException secondary) {
primary.addSuppressed(secondary); // ✅ 正确：添加为被抑制异常
}
throw primary;
- 只能对
Throwable及其子类（如Exception、Error）调用，但addSuppressed()在Throwable中定义，所有异常都支持 - 被抑制异常本身不能是
null，否则抛NullPointerException - 同一个异常对象不能重复添加（会忽略）；也不能把自己加为自己（会抛
IllegalArgumentException）
与 try-with-resources 的自动抑制对比
try-with-resources 会在资源关闭异常与主异常共存时，自动将关闭异常作为 suppressed 添加进主异常。例如：
try (FileInputStream in = new FileInputStream("a.txt")) {
throw new RuntimeException("Read failed");
} // 如果 close() 抛 IOException，它会被自动 suppress
而手动调用 addSuppressed() 是对这种机制的补充和扩展，适用于非 try-with-resources 场景，比如：
- 手动管理连接、线程、锁、临时文件等资源
- 在
catch块中执行清理逻辑并捕获新异常 - 封装异常时保留上下文细节（如同时报告验证失败 + 日志写入失败）
查看和调试被抑制的异常
打印异常堆栈时，JDK 7+ 默认会显示 suppressed 部分（以 Suppressed: ... 开头）。你也可以主动检查：
try {
// ...
} catch (Throwable t) {
System.err.println("Primary: " + t);
for (Throwable s : t.getSuppressed()) {
System.err.println("Suppressed: " + s);
}
}
-
getSuppressed()返回Throwable[]，长度可能为 0 - 被抑制异常的堆栈不会自动展开到主异常的
printStackTrace()中（除非使用重载版本printStackTrace(PrintStream)，默认已支持） - 日志框架（如 Log4j、SLF4J）通常能正确渲染 suppressed 异常，前提是底层使用 JDK 的标准输出逻辑
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
