ExceptionUtils.getStackTrace()是Apache Commons Lang提供的将Throwable转为完整堆栈字符串的方法，用于日志记录、告警或监控上报等需全量堆栈的场景，不输出到控制台。
ExceptionUtils.getStackTrace() 是什么，什么时候该用它
它不是 JDK 自带的，而是 org.apache.commons.lang3.exception.ExceptionUtils 提供的静态方法，作用是把 Throwable 转成带换行符的完整字符串——内容和 e.printStackTrace() 一模一样，但不输出到控制台，适合写日志、落库或网络传输。
适用场景很明确：你要记录或转发「全量堆栈」，而不是只看异常类型或消息。比如异步任务失败后发告警邮件、上报监控平台、存入错误日志表。
- 传参必须是
Throwable子类（Exception、Error、RuntimeException都行），不能传null，否则 NPE - 别传
e.toString()或e.getMessage()给它——它只认原始异常对象 - 返回值已含换行符，写入文件时不用额外拼
\n，否则会多空行
不引入 Commons Lang 怎么办：手写等效实现
如果项目禁用第三方依赖，可以用 JDK 原生方式自己写一个行为一致的 getStackTrace()：
public static String getStackTraceAsString(Throwable t) {
if (t == null) return "null";
StringWriter sw = new StringWriter();
t.printStackTrace(new PrintWriter(sw));
return sw.toString();
}
这段代码和 ExceptionUtils.getStackTrace() 几乎完全等价，但要注意两点：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 每次调用都新建
StringWriter和PrintWriter，短生命周期没问题；高频调用（比如每毫秒一次）可能触发频繁 GC - 必须判空
t == null，否则printStackTrace()会直接抛 NPE，而 Commons Lang 版本内部做了防护
只想要异常类型+消息？别用 getStackTrace()
ExceptionUtils.getStackTrace() 是全量堆栈，开销比 e.toString() 大不少。如果你只是想快速打个简要日志（比如 SLF4J 的 log.warn("fail: {}", e.toString())），直接用 e.toString() 更轻量、更安全。
-
e.toString()=e.getClass().getName() + ": " + e.getMessage()，不含堆栈，也不怕getMessage()为null -
NullPointerException的getMessage()很可能为null，直接拼接会 NPE；但e.toString()会处理成"java.lang.NullPointerException" - 生产环境日志中，第一行摘要信息用
e.toString()，详细分析才用getStackTrace()
堆栈里真正出问题的地方，往往不在最外层
getStackTrace() 返回的是整个调用链，但业务异常常被框架层层包装（比如 Spring 把 SQLException 包进 RuntimeException）。光看顶层堆栈，大概率找不到根因。
- 用
ExceptionUtils.getRootCause(e)或手动遍历getCause()才能拿到最底层异常 - 堆栈第一帧（
e.getStackTrace()[0]）才是真实出错位置，但嵌套异常的「第一帧」属于包装层，得先穿透再取 - 日志框架如 Logback 的
%ex或%throwable格式符默认会展开整个异常链，比手撕getStackTrace()更省心也更可靠
真正容易被忽略的是：堆栈信息本身不带线程名、时间戳、MDC 上下文——这些得靠日志框架补全，或者你手动拼。别指望 getStackTrace() 返回的字符串里有这些。
