java中可通过递归调用getcause()并用identityhashset检测循环引用来获取根源异常，即最后一个非null且cause为null（或自引用）的throwable，再将其传入日志框架或打印堆栈。
<p>Java中异常链过长时，可通过自定义打印逻辑递归遍历 <code>getCause()</code>，只输出最底层的根本原因（即最后一个非 null 的 cause），跳过中间冗余堆栈。</p> <h3>获取根源异常（Root Cause）</h3> <p>根源异常是异常链中最后一个有实际意义的 <code>Throwable</code>，通常不为 null 且其 <code>getCause()</code> 返回 null（或自身）。注意：不是所有异常都通过 <code>initCause()</code> 或构造函数设置 cause，需安全遍历。</p>
- 用 while 循环持续调用
getCause()，直到返回 null 或遇到循环引用（如 cause 指向自身或已见过的异常） - 建议用
Set<throwable></throwable>记录已访问异常，防止因错误封装导致的无限循环 - 若整条链无 cause（即原始异常本身无嵌套），则根源就是它自己
自定义打印方法示例
以下是一个轻量、线程安全的工具方法，仅打印根源异常的类名和消息，并可选输出其完整堆栈（不打印中间层）：
<code>public static void printRootCause(Throwable t) {
Throwable root = t;
Set<throwable> seen = new IdentityHashSet();
while (root != null && !seen.contains(root)) {
seen.add(root);
Throwable cause = root.getCause();
if (cause == null || cause == root) break; // 终止条件
root = cause;
}
System.err.println("Root cause: " + root.getClass().getName() + ": " + root.getMessage());
root.printStackTrace(System.err); // 只打根源的堆栈
}</throwable></code>
配合日志框架（如 SLF4J / Log4j）使用
避免直接调用 printStackTrace()，推荐将根源异常作为 throwable 参数传给日志方法，让日志框架处理格式化：
- SLF4J：
log.error("Operation failed", root); - Log4j2：
logger.error("Operation failed", root); - 确保日志配置未开启“打印完整异常链”，否则仍可能输出中间层 —— 根源异常传入后，日志器默认只渲染该异常本身
进阶：包装成 DiagnosticException 工具类
若项目多处需要此能力，可封装静态工具类，支持带上下文信息的根源提取：
- 提供
getRootCause(Throwable)返回Throwable，供上层自由处理 - 提供
getRootMessage(Throwable)返回简洁字符串（如"NullPointerException: key cannot be null"） - 对
InvocationTargetException等特殊类型，可额外解包getTargetException()，因为它的 cause 语义不同
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
