关键在于调用logger.error("msg", e)时第二个参数必须为非null的Throwable类型，且日志配置中启用%ex或%xEx；否则堆栈会丢失或截断。
Java中使用 log.error("msg", e) 打印带异常堆栈的日志，关键在于：日志框架必须识别第二个参数为 Throwable 类型，且日志配置中需启用堆栈输出（默认通常已开启）。只要方法签名匹配、异常对象非 null，堆栈就会自动完整打印。
Logback 正确用法
Logback 的 Logger.error(String, Throwable) 方法专为此设计：
- 确保调用的是带
Throwable参数的重载方法（不是error(String, Object...)） - 异常对象不能为
null，否则只打印消息，不输出堆栈 - SLF4J 绑定 Logback 后，以下写法即可输出完整堆栈：
Log4j2 正确用法
Log4j2 的 Logger.error(String, Throwable) 同样支持：
- 必须使用
Throwable类型参数（不是Exception子类变量被当作普通 Object） - 若误写成
logger.error("msg", e.getMessage())或logger.error("msg", e.toString())，堆栈会丢失 - 推荐写法：
常见踩坑点
以下情况会导致堆栈不显示或截断：
立即学习“Java免费学习笔记（深入）”；
-
用错方法签名：例如 SLF4J 下写了
log.error("msg", e, "extra")，触发的是error(String, Object...)，e 被当普通参数，堆栈消失 -
日志级别配置过低：确认
error级别未被过滤（如 root logger 设为 WARN） -
Appender 配置限制：某些自定义 Appender 或异步日志器可能默认截断堆栈（如 Log4j2 AsyncLogger 默认不限制，但自定义 Layout 若没包含
%throwable或%ex，控制台可能不显） -
异常被包装多次：如
new RuntimeException("wrap", e)，Logback/Log4j2 默认只展开一层；需配置%xEx（Logback）或%throwable{full}（Log4j2）显示全链路
验证是否生效的小技巧
快速检查堆栈是否正常输出：
- 在测试中故意抛出异常并调用
log.error("test", new RuntimeException("boom")) - 观察日志输出末尾是否有
at xxx.xxx.xxx开头的多行堆栈 - 若只有消息没有堆栈，立即检查方法调用签名和异常变量是否为真实
Throwable实例
