java异常链通过new runtimeexception(msg, cause)等带cause构造器显式传递原始异常，保留完整堆栈；必须避免拼接getmessage()、误用initcause()、静默吞异常；验证看printstacktrace是否含“caused by”层级。
Java异常链（Exception Chaining）通过 Throwable 的构造函数（如 new RuntimeException(msg, cause)）将底层异常作为“原因”（cause）嵌入上层异常，从而在打印堆栈时自动展开完整调用链，保留原始错误源头的类名、方法、行号和上下文。关键不是简单地“捕获再抛出”，而是**显式传递原始异常对象，并避免覆盖其堆栈轨迹**。
正确构建异常链：用带 cause 的构造器
必须使用支持 cause 参数的异常构造器，而非手动拼接消息或重新 throw 新异常：
- ✅ 正确：
throw new ServiceException("订单创建失败", originalException); - ❌ 错误：
throw new ServiceException("订单创建失败: " + originalException.getMessage());（丢失堆栈、丢失 cause） - ❌ 错误：
throw new ServiceException("订单创建失败").initCause(originalException);（虽设了 cause，但 initCause 只能调用一次且不推荐用于构造阶段）
避免意外中断链：不要吞掉原始异常
以下操作会切断异常链，导致原始堆栈不可见：
- 捕获后仅记录日志却不 re-throw，或仅 throw 一个全新异常且未传 cause
- 在 catch 块中调用
e.printStackTrace()后静默返回，使调用方无法感知底层失败 - 用
Optional.orElseThrow(() -> new XxxException())包装可能为 null 的值时，若原始异常已存在，却未将其作为 cause 传入
验证链是否生效：检查 printStackTrace 输出
调用 exception.printStackTrace() 时，若链完整，输出中会出现明确的 Caused by: 层级缩进：
com.example.ServiceException: 订单创建失败
at com.example.OrderService.create(OrderService.java:42)
...
Caused by: java.sql.SQLTimeoutException: ORA-01013: 用户请求取消当前操作
at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:509)
...
只要看到至少一层 Caused by: 且其内容与原始异常一致，就说明链已保留源头堆栈。
框架集成注意点：Spring、JAX-RS 等默认支持
主流框架通常自动识别 cause 并透传堆栈：
- Spring MVC 遇到带 cause 的异常，默认会在响应体或日志中展开整个链（需开启 debug 日志或配置
include-stacktrace=always） - JAX-RS（如 Jersey）的
ExceptionMapper接收异常时，可直接调用exception.getCause()获取原始异常 - Logback/Log4j2 记录异常时，默认启用
%ex{full}或%xEx即可完整输出链式堆栈
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
