需手动循环调用getCause()逐层获取嵌套异常，每次返回Throwable或null，应设深度限制防环形引用；仅通过initCause()或含cause参数的构造函数创建的嵌套才有效。
Java中如何用 getCause() 逐层获取嵌套异常
多层嵌套异常（比如 SQLException 包裹 IOException，再包裹 NullPointerException）不会自动展开，必须手动调用 getCause() 向下追溯。JVM 不会递归打印全部原因，printStackTrace() 虽然会显示「Caused by」链，但程序里拿不到完整路径。
-
getCause()返回Throwable，可能为null（如是根异常或未设置 cause） - 需循环调用，直到返回
null；建议加深度限制（如 10 层），防止无限循环（某些框架异常会构造环形引用） - 注意：
initCause()和带cause参数的构造函数才能建立嵌套关系，不是所有异常都天然嵌套
Throwable t = e;
int depth = 0;
while (t != null && depth < 10) {
System.err.println("[" + depth + "] " + t.getClass().getSimpleName() + ": " + t.getMessage());
t = t.getCause();
depth++;
}
使用 ExceptionUtils.getRootCause()（Apache Commons Lang）简化处理
手写循环容易漏判或越界，org.apache.commons.lang3.exception.ExceptionUtils 提供了稳定封装。它内部做了空值检查、环检测和深度截断，默认最多查 50 层。
- 依赖需显式引入：
org.apache.commons:commons-lang3:3.12.0 -
getRootCause(e)返回最底层异常（非包装器），适合做统一错误码映射 -
getThrowableList(e)返回从外到内的List<throwable></throwable>，可用于日志结构化输出
import org.apache.commons.lang3.exception.ExceptionUtils;
// ...
Throwable root = ExceptionUtils.getRootCause(e);
if (root instanceof NullPointerException) {
// 处理原始空指针
}
自定义异常构造时必须显式传入 cause 参数
很多人在封装业务异常时直接 new 一个新异常，却忘了把原始异常设为 cause，导致嵌套链断裂。一旦丢失，上层无法区分是数据库超时还是连接被拒绝。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 错误写法：
throw new ServiceException("订单创建失败");—— 彻底丢弃原始异常 - 正确写法：
throw new ServiceException("订单创建失败", e);（前提是构造函数支持Throwable cause） - 若自定义异常没实现 cause 构造函数，需手动调用
initCause(e)，且只能调用一次
Spring 中 @ExceptionHandler 捕获嵌套异常的陷阱
Spring 的异常处理器默认只匹配抛出的最外层异常类型。即使你 catch 了 ServiceException，它的 cause 是 TimeoutException，也不会触发 @ExceptionHandler<timeoutexception></timeoutexception>。
立即学习“Java免费学习笔记（深入）”；
- 想按根异常处理，得自己在 handler 里用
ExceptionUtils.getRootCause()判断 - 或者用 Spring 的
@ExceptionHandler配合instanceof+ 循环遍历getCause() - 注意：AOP 或事务代理可能额外包一层
UndeclaredThrowableException，需一并考虑
嵌套异常的还原成本高，真正关键的往往只是最内层那个——别指望靠外层消息猜问题，拿到 getCause() 链后，优先检查第一个非框架类的异常实例。
