printStackTrace()可快速输出完整堆栈到System.err,适用于开发调试;需判空避免NPE;获取字符串应使用StringWriter+PrintWriter;日志中须传Throwable实例而非字符串拼接。

用 printStackTrace() 最快打出完整堆栈
直接调用异常对象的 printStackTrace() 方法,是开发时最常用、最省事的方式。它会把异常类型、消息和每一层调用栈(包括类名、方法名、行号)输出到 System.err。
- 适用于开发调试、本地日志快速定位,不建议在生产环境大量使用(可能干扰日志结构)
- 注意:如果异常是
null,会抛出NullPointerException,调用前建议判空 - 该方法默认输出到标准错误流,无法直接捕获为字符串;如需字符串形式,请改用
getStackTrace()或Throwable.printStackTrace(PrintWriter)
用 StringWriter + PrintWriter 获取堆栈字符串
当需要把堆栈转成字符串(比如写入日志文件、拼接到报警消息、或通过网络上报),必须绕过 printStackTrace() 的直接输出行为,手动构造可读字符串。
StringWriter sw = new StringWriter(); PrintWriter pw = new PrintWriter(sw); e.printStackTrace(pw); String stackTrace = sw.toString(); // 此时 stackTrace 包含完整堆栈
-
StringWriter是字符输出流,PrintWriter将其包装为格式化打印接口 - 务必调用
pw.close()或sw.close()(虽然这里影响不大,但属良好习惯) - 别用
e.toString()代替——它只返回异常类名和 message,没有堆栈
用 Arrays.toString(e.getStackTrace()) 只取调用帧,不推荐
e.getStackTrace() 返回 StackTraceElement[],每个元素代表一层调用。有人误以为 Arrays.toString(...) 能替代完整堆栈输出,实际效果差很多。
- 输出格式生硬,无异常头信息(如
java.lang.NullPointerException: null) - 缺少嵌套异常(
getCause())链路,遇到InvocationTargetException等包装异常时极易漏关键原因 - 行号和类名虽在,但丢失了源码路径、模块信息等上下文,可读性弱
Log4j / SLF4J 日志框架中正确记录异常
在使用日志框架时,不能只写 logger.error("failed", e) 这样的占位符——必须确保第二个参数是 Throwable 类型,否则堆栈不会自动打印。
立即学习“Java免费学习笔记(深入)”;
- ✅ 正确:
logger.error("DB query failed", e);—— 框架识别Throwable并展开堆栈 - ❌ 错误:
logger.error("DB query failed: " + e);——e被转成字符串,只剩toString()结果 - Logback 默认会打印 cause 链(如
Caused by: ...),但前提是异常对象本身包含cause且未被吞掉(比如 catch 后没 re-throw 或没设 cause)
Throwable 实例——中间任何一次「仅取 message」或「new Exception(msg)」都会切断线索。











