应直接将异常对象传给日志方法，如 logger.error("操作失败", e)，由日志框架自动输出完整堆栈；避免 e.toString()、printStackTrace() 或手动拼接堆栈字符串。
在 Java 日志中打印异常堆栈信息，最直接有效的方式是将 异常对象本身作为参数传给日志方法，而不是只打印 e.toString() 或 e.getMessage()。这样日志框架（如 Log4j、Logback、SLF4J）会自动输出完整的堆栈跟踪。
用日志框架的异常重载方法
主流日志 API 都提供了接收 Throwable 参数的重载方法：
- SLF4J：
logger.error("操作失败", e); - Log4j2：
logger.error("操作失败", e); - Logback（兼容 SLF4J）：
logger.warn("解析异常", e);
✅ 正确：完整堆栈会追加在日志消息后，包含异常类型、消息、每一层调用位置。
❌ 错误：logger.error("操作失败: " + e); 或 logger.error(e.getStackTrace().toString()); —— 只输出字符串形式，丢失格式和可读性。
避免手动调用 printStackTrace()
e.printStackTrace() 默认输出到 System.err，不经过日志系统，无法统一管理（如异步、分级、落盘、脱敏）。它绕过日志配置，不利于运维排查。
- 不推荐：
e.printStackTrace(); - 更不推荐：
e.printStackTrace(new PrintWriter(stringWriter));再拼接进日志 —— 多余且易出错
需要自定义堆栈时，用日志工具类辅助
极少数场景需截取或过滤堆栈（如去除非业务包），可用 org.apache.commons.lang3.exception.ExceptionUtils：
-
ExceptionUtils.getStackTrace(e)→ 返回完整字符串 -
ExceptionUtils.getRootCauseMessage(e)→ 获取根本原因消息 -
ExceptionUtils.getStackTrace(e, 5)（Log4j2 扩展）→ 限制行数
但一般无需手动处理，优先交给日志框架原生支持。
确保日志级别和配置支持错误堆栈
部分日志配置可能关闭了 ERROR 级别或设置了低输出精度：
- 检查 logback.xml / log4j2.xml 中 root logger 级别是否 ≥ ERROR
- 确认 appender 的
PatternLayout不要误删%ex（Logback）或%throwable（Log4j2）占位符 - 例如 Logback 典型 pattern：
%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%ex%n
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
