异常链是Java中通过将原始异常作为新异常的cause传递，形成可追溯的异常链条。使用getCause()可逐层获取引发当前异常的上层异常，直至找到根本原因，便于调试和日志分析。在封装异常时应使用带cause参数的构造函数，避免调用fillInStackTrace()导致链路断裂，并通过日志框架打印完整堆栈信息以保留整个异常链。
在Java中，异常链（Exception Chaining）是一种将多个异常关联起来的机制，通常用于保留原始异常信息的同时抛出一个新的、更符合当前上下文的异常。通过 Exception.getCause() 方法，可以追溯异常发生的根本原因，这对调试和日志分析非常有帮助。
什么是异常链
异常链是指一个异常由另一个异常引发的情况。Java允许在抛出新异常时，把原始异常作为“原因”（cause）传入构造函数，从而形成链条。这种机制常见于捕获底层异常后封装为业务异常再抛出的场景。
例如：
try {
// 可能抛出 IOException
readFile();
} catch (IOException e) {
throw new BusinessException("读取文件失败", e);
}
这里的 BusinessException 就是外层异常，而 IOException 是其“原因”，可以通过 getCause() 获取。
立即学习“Java免费学习笔记（深入）”；
使用 getCause() 追踪异常根源
getCause() 是 Throwable 类的方法，返回导致当前异常的异常对象。如果无明确原因，则返回 null。
基本用法如下：
try {
// 一些操作
} catch (Exception e) {
System.out.println("顶层异常: " + e.getMessage());
Throwable cause = e.getCause();
if (cause != null) {
System.out.println("根本原因: " + cause.getMessage());
System.out.println("原始异常类型: " + cause.getClass().getSimpleName());
}
}
但实际中异常链可能不止一层，需要递归遍历才能找到最深层的根源。
完整异常链的遍历方法
为了全面分析异常链，建议循环调用 getCause()，直到返回 null 或出现重复引用（防止无限循环）。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
示例代码：
public static void printExceptionChain(Throwable ex) {
int depth = 0;
System.out.println("=== 开始追踪异常链 ===");
while (ex != null) {
System.out.printf("层级 %d: %s: %s%n",
depth, ex.getClass().getSimpleName(), ex.getMessage());
ex = ex.getCause();
depth++;
}
System.out.println("=== 异常链结束 ===");
}
调用此方法可清晰看到从顶层异常到原始异常的完整路径。
比如输出可能是：
=== 开始追踪异常链 === 层级 0: BusinessException: 业务处理失败 层级 1: SQLException: 数据库连接中断 层级 2: SocketException: 网络连接超时 === 异常链结束 ===
这样就能快速定位问题源头是网络故障。
配合 fillInStackTrace 和日志框架使用
有时为了性能或安全，会重新抛出异常并调用 fillInStackTrace() 清除原堆栈。但这样做可能会切断异常链，除非显式设置 cause。
推荐始终使用带 cause 参数的构造函数来保持链路完整：
throw new RuntimeException("封装异常", originalException);
在日志记录中，应打印完整的异常栈（直接打印 e），它会自动包含整个链的信息：
logger.error("操作失败", e); // 自动输出整个异常链堆栈
基本上就这些。合理利用 getCause() 和异常链机制，能大幅提升错误排查效率。关键是保持链路不断，在封装异常时不丢失原始信息。
