最直接输出完整堆栈的方式是调用异常对象的printStackTrace()方法;需注意其默认输出到System.err、不适用于日志集成且多线程下可能混杂。

用 printStackTrace() 快速输出完整堆栈
最直接的方式是调用异常对象的 printStackTrace() 方法,它会把整个调用链(包括类名、方法名、行号)输出到 System.err:
try {
int x = 1 / 0;
} catch (ArithmeticException e) {
e.printStackTrace();
}
注意:该方法默认输出到标准错误流,不适合日志系统集成;在多线程环境下,多个线程同时调用可能造成输出混杂。
用 Throwable.getStackTraceString() 获取字符串形式堆栈
如果需要将堆栈转为字符串(比如写入日志文件、上报监控系统),应使用 String.valueOf(e) 或更规范的 Arrays.toString(e.getStackTrace()) ——但更推荐 JDK 7+ 引入的静态工具方法:
import java.util.logging.Logger;
try {
throw new RuntimeException("test");
} catch (Throwable e) {
String stack = e.getStackTraceString(); // JDK 7+
Logger.getLogger("demo").severe(stack);
}
这个方法返回的是完整可读字符串,包含异常类型、消息和逐帧堆栈,且线程安全。低于 JDK 7 的环境需手动构造,例如用 StringWriter + PrintWriter 捕获输出。
立即学习“Java免费学习笔记(深入)”;
Log4j / SLF4J 日志框架中正确记录异常
直接拼接字符串(如 logger.error("failed: " + e))只会输出 toString() 结果,丢失堆栈。必须把异常作为最后一个参数传入:
-
logger.error("Operation failed", e);✅ 自动展开堆栈 -
logger.error("Operation failed: " + e);❌ 只有异常头,无堆栈 -
logger.error("Operation failed", e.getMessage());❌ 类型错误,编译不通过
SLF4J 的占位符语法也支持:logger.error("User {} failed with {}", userId, e);,只要异常是最后一个参数,堆栈仍会被记录。
自定义异常处理器里别漏掉 cause 链
嵌套异常(如 new IOException("read error", cause))可能有多层 getCause()。只调用一次 printStackTrace() 不会递归打印所有 cause —— 它默认只展开第一层。
若需完整因果链,得手动遍历:
public static void printFullStackTrace(Throwable t) {
while (t != null) {
t.printStackTrace();
t = t.getCause();
if (t != null) System.err.println("Caused by:");
}
}
多数日志框架(Logback、Log4j2)默认支持递归展开,但自研监控上报或简单 System.err 输出时,这点极易被忽略。











