getStackTrace() 返回 StackTraceElement[] 数组，仅含类名、方法名、文件名和行号，不含异常类型、消息或 cause 链；需遍历调用 toString() 才可读，递归 getCause() 才能获取完整异常链。
getStackTrace() 返回的是什么，为什么不能直接打印出完整异常信息
Throwable.getStackTrace() 返回的是 StackTraceElement[] 数组，每个元素只包含类名、方法名、文件名和行号，**不包含异常类型、消息、嵌套 cause 或任何格式化换行**。它只是调用栈的“快照”，不是 printStackTrace() 那种可读输出。
常见错误是直接 System.out.println(e.getStackTrace())，结果看到类似 [Ljava.lang.StackTraceElement;@1b6d3586 —— 这是数组默认 toString()，没遍历就无效。
- 必须手动遍历数组，逐个调用
toString()或提取字段 - 若需包含 cause 链，
getStackTrace()完全不处理，得递归调用getCause() - JVM 优化（如栈折叠）可能导致某些帧被省略，尤其在深度递归或 JIT 编译后
如何安全遍历并格式化 getStackTrace() 结果
最简可靠方式是用 for-each 循环 + StackTraceElement.toString()，它已按 at ClassName.methodName(FileName.java:line) 格式组织好：
for (StackTraceElement element : e.getStackTrace()) {
System.out.println("\tat " + element);
}
注意：开头加 \tat 是为了对齐标准异常输出风格；不加也行，但混合日志时易混淆层级。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 避免用
Arrays.toString()—— 它会加方括号和逗号，破坏可读性 - 若需结构化数据（比如存 JSON），提取字段更稳妥：
element.getClassName()、element.getMethodName()、element.getLineNumber() - 某些环境（如 Android 或老版 JDK）中
getFileName()可能返回null，使用前应判空
获取完整异常链（包括 cause）需要自己递归拼接
getStackTrace() 只返回当前异常的栈，不涉及 cause。要模拟 printStackTrace() 的完整效果，必须手动展开嵌套：
public static void printFullStackTrace(Throwable t) {
while (t != null) {
System.out.println(t.toString());
for (StackTraceElement e : t.getStackTrace()) {
System.out.println("\tat " + e);
}
t = t.getCause();
if (t != null) {
System.out.println("Caused by: " + t.toString());
}
}
}
- 每次循环处理一个
Throwable实例，打印其消息 + 栈，再跳到getCause() - 务必检查
t != null，否则空 cause 会 NPE - 有些框架（如 Spring）会包装异常但不清除原始 cause，导致链很长；生产环境建议限制递归深度（如最多 5 层）防止无限循环
性能与兼容性要注意的几个点
频繁调用 getStackTrace() 有开销：JVM 需捕获当前线程栈并生成对象数组，尤其在高并发或高频异常场景下明显。
- 不要在非异常路径（如正常逻辑分支）里无故调用它——栈采集本身就会触发 JVM 开销
- Java 7+ 支持
Throwable.setStackTrace(StackTraceElement[])，可用于测试伪造栈，但生产慎用，可能干扰诊断 - 在 GraalVM Native Image 中，栈信息可能被裁剪或不可用，需开启
--enable-url-protocols=http等配置并验证实际行为
真正关键的不是“怎么拿到栈”，而是“要不要拿”——多数时候记录日志用 logger.error("msg", e) 就够了，getStackTrace() 是给自定义诊断、监控埋点或序列化异常元数据用的，别当成默认操作。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
