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>
<ul>
<li>用 while 循环持续调用 <code>getCause()</code>，直到返回 null 或遇到循环引用（如 cause 指向自身或已见过的异常）</li>
<li>建议用 <code>Set<Throwable></code> 记录已访问异常，防止因错误封装导致的无限循环</li>
<li>若整条链无 cause（即原始异常本身无嵌套），则根源就是它自己</li>
</ul>
<H3>自定义打印方法示例</H3>
<p>以下是一个轻量、线程安全的工具方法，仅打印根源异常的类名和消息，并可选输出其完整堆栈（不打印中间层）：</p>
<pre><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); // 只打根源的堆栈
}</code></pre>
<H3>配合日志框架（如 SLF4J / Log4j）使用</H3>
<p>避免直接调用 <code>printStackTrace()</code>，推荐将根源异常作为 <code>throwable</code> 参数传给日志方法，让日志框架处理格式化：</p>
<ul>
<li>SLF4J：<code>log.error("Operation failed", root);</code></li>
<li>Log4j2：<code>logger.error("Operation failed", root);</code></li>
<li>确保日志配置未开启“打印完整异常链”，否则仍可能输出中间层 —— 根源异常传入后，日志器默认只渲染该异常本身</li>
</ul>
<H3>进阶：包装成 DiagnosticException 工具类</H3>
<p>若项目多处需要此能力，可封装静态工具类，支持带上下文信息的根源提取：</p>
<ul>
<li>提供 <code>getRootCause(Throwable)</code> 返回 <code>Throwable</code>，供上层自由处理</li>
<li>提供 <code>getRootMessage(Throwable)</code> 返回简洁字符串（如 <code>"NullPointerException: key cannot be null"</code>）</li>
<li>对 <code>InvocationTargetException</code> 等特殊类型，可额外解包 <code>getTargetException()</code>，因为它的 cause 语义不同</li>
</ul>
