如何在 Java 中利用 ExceptionUtils 在日志中打印过滤掉冗余框架信息的精简异常堆栈-java教程-PHP中文网

apache commons lang 的 exceptionutils 可快速提取业务异常根源，通过 getrootcause 获取最内层异常，getstacktrace 打印其堆栈，并可用 getrootcausestacktrace 结合包名过滤精简日志，再配合 slf4j mdc 添加 traceid、userid 等上下文提升排查效率。

使用 apache commons lang 的 exceptionutils 可以快速提取“业务相关”的异常根源，跳过 spring、tomcat、servlet 等框架层的冗余堆栈，让日志更聚焦问题本质。

引入依赖确保可用 ExceptionUtils

确认项目中已引入 commons-lang3（3.12.0+ 推荐）：

<dependency><groupid>org.apache.commons</groupid><artifactid>commons-lang3</artifactid><version>3.14.0</version></dependency>

注意：不要用旧版 commons-lang（2.x），它没有 ExceptionUtils 的现代过滤方法。

用 getRootCause + getStackTrace 聚焦根本原因

多数深层异常（如数据库连接失败、空指针）被层层包装（RuntimeException → ServiceException → WebException），直接打印 e.printStackTrace() 会淹没关键行。推荐组合使用：

ExceptionUtils.getRootCause(e)：穿透所有包装异常，拿到最内层原始异常（如 SQLException 或 NullPointerException）
ExceptionUtils.getStackTrace(cause)：仅打印该根源异常的完整堆栈（不含外层包装类的无关调用帧）

示例代码：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

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

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

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

若连根源异常的堆栈里仍有大量 org.springframework.*、javax.servlet.* 等非业务代码，可用：

ExceptionUtils.getRootCauseStackTrace(e)：返回 String[]，每行为一行堆栈；可遍历过滤掉含指定包名的行
手动保留以你公司包名（如 com.yourcompany.service.）或核心工具类开头的行

轻量过滤示例：

String[] trace = ExceptionUtils.getRootCauseStackTrace(e);
List<string> 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));</string>