Java使用ExceptionUtils打印精简异常堆栈日志方法

排查线上异常时，最令人困扰的往往是长达数百行的堆栈日志。满屏的 org.springframework.*、ja vax.servlet.* 等框架调用链，将真正引发问题的业务代码完全淹没。是否存在一种方法，能让日志直指核心，只展示我们关注的关键错误信息？

答案是肯定的。通过使用 Apache Commons Lang 库中的 ExceptionUtils 工具类，我们可以快速剥离异常的多层包装，直达问题根源。它能够提取最内层的业务异常，过滤掉冗余的框架堆栈信息，从而使日志变得清晰、聚焦，显著提升问题定位的效率。

引入依赖确保 ExceptionUtils 可用

首先，需要确保你的项目已引入 commons-lang3 依赖。推荐使用 3.12.0 或更高版本，以获得更完整的功能支持。

  org.apache.commons
  commons-lang3
  3.14.0

这里有一个关键细节需要注意：务必使用 commons-lang3，而非旧的 commons-lang（2.x 版本）。后者不包含我们将要使用的现代过滤方法。

使用 getRootCause 与 getStackTrace 聚焦根本原因

在复杂的业务系统中，底层的原始异常（例如 SQLException 或 NullPointerException）常常被业务层、框架层多次包装。最终抛出的可能是一个 RuntimeException → ServiceException → WebException 的复合体。如果直接调用 e.printStackTrace()，关键信息极易被层层调用帧淹没。

此时，ExceptionUtils 的组合方法便能发挥作用：

• ExceptionUtils.getRootCause(e)：该方法能穿透所有包装，直接获取最内层、最原始的异常对象。
• ExceptionUtils.getStackTrace(cause)：获取根源异常后，使用此方法得到其堆栈字符串。这样打印的日志将仅包含根本原因的调用链，外层包装类的无关信息已被剔除。

具体代码示例如下：

import org.apache.commons.lang3.exception.ExceptionUtils;

try {
    // 你的业务逻辑
} catch (Exception e) {
    Throwable root = ExceptionUtils.getRootCause(e);
    log.error("业务异常: {} \n{}", root, ExceptionUtils.getStackTrace(root));
}

进一步精简：使用 getRootCauseStackTrace 过滤框架包名

有时，即使获取了根源异常的堆栈，其中仍可能混杂大量 Spring、Servlet 或其他框架的调用信息。对于只想关注自身业务代码的开发者而言，这还不够“干净”。

更精细的过滤方法如下：

• ExceptionUtils.getRootCauseStackTrace(e)：该方法返回一个字符串数组（String[]），每个元素对应堆栈中的一行。这为我们提供了按行处理、自由过滤的可能性。
• 你可以遍历此数组，手动过滤掉包含特定包名（如 org.springframework.*）的行，仅保留以公司业务包名（例如 com.yourcompany.service.*）开头的行，或保留关键的“Caused by:”行。

以下是一个轻量级的过滤示例：

String[] trace = ExceptionUtils.getRootCauseStackTrace(e);
List cleanTrace = Arrays.stream(trace)
    .filter(line -> line.contains("com.yourcompany.") ||
                    line.contains("Caused by:") ||
                    line.startsWith("\tat "))
    .collect(Collectors.toList());
log.error("精简堆栈:\n{}", String.join("\n", cleanTrace));

配合 SLF4J MDC 实现上下文增强

精简堆栈后，问题定位已快了许多。若能在日志中直接看到是哪个用户、哪次请求触发的异常，排查效率还能进一步提升。这需要借助 SLF4J 的 MDC（Mapped Diagnostic Context，映射诊断上下文）功能。

核心思路是在捕获异常前，将关键上下文信息存入线程绑定的 MDC 中：

• MDC.put("traceId", UUID.randomUUID().toString())：为当前请求生成唯一追踪ID。
• MDC.put("userId", currentUser.getId())：存入当前用户ID。

随后，在 Logback 等日志框架的配置文件中，使用 %X{traceId} 这类占位符。这样，每条日志都会自动附带该追踪标识。当精简后的异常堆栈与清晰的请求上下文同时出现在日志中时，问题定位几乎可以达到“秒级”响应。

总而言之，将 ExceptionUtils 的精准提取与过滤能力，同 MDC 的上下文追踪能力相结合，是从海量日志中快速定位问题的有效策略。这套组合技能使你的异常日志从“噪音”转变为清晰的“信号”，成为高效运维的得力助手。