在Java里如何使用ExceptionUtils获取堆栈信息_Java异常工具说明

P粉602998670 2026-01-15 00:00:00 次阅读

ExceptionUtils.getStackTrace()可获取带换行的完整堆栈字符串，但需引入Apache Commons Lang3依赖，因其非JDK原生类；若无法引入，可用StringWriter+PrintWriter手动实现等效逻辑。

直接用 ExceptionUtils.getStackTrace() 就能拿到带换行的完整堆栈字符串，但前提是你要先引入 Apache Commons Lang —— 这个类不在 JDK 标准库中。

为什么 `ExceptionUtils` 不能直接用

Java 原生没有 ExceptionUtils 类。它属于 org.apache.commons:commons-lang3，必须显式添加依赖：

 
    org.apache.commons
    commons-lang3
    3.14.0

用 Maven 时漏掉依赖
会报 ClassNotFoundException: org.apache.commons.lang3.exception.ExceptionUtils
IntelliJ 或 Eclipse 中即使写了 import，也会标红，因为类根本不存在于 classpath
注意包名是 org.apache.commons.lang3.exception.ExceptionUtils，不是 lang 或 lang2

`ExceptionUtils.getStackTrace()` 的实际用法

它接受 Throwable 子类（Exception、Error、RuntimeException 都行），返回一个含换行符的 String，内容和 e.printStackTrace() 输出一致，但不打印到控制台，便于记录或传输：

try {
    throw new IllegalArgumentException("参数错误");
} catch (Exception e) {
    String stackTrace = ExceptionUtils.getStackTrace(e);
    log.error("捕获异常：{}", stackTrace); // 注意这里传的是字符串，不是 e
}

不要传 e.toString() 或 e.getMessage() 给它——它只认 Throwable
返回值已包含换行，写入日志文件时无需额外加 \n
如果只想要“第一行”（即异常类型 + 消息），用 e.toString() 更轻量；getStackTrace() 是全量，开销略大

替代方案：不用 Commons Lang 怎么办

如果项目不允许引入第三方依赖，可用 JDK 原生方式构造类似效果：

public static String getStackTraceAsString(Throwable t) {
    StringWriter sw = new StringWriter();
    t.printStackTrace(new PrintWriter(sw));
    return sw.toString();
}