应使用日志框架接收throwable参数的重载方法（如logger.error("msg", e)）并确保日志配置pattern包含%ex或%throwable，避免仅拼接e.getmessage()、手动printstacktrace()或错误包装异常导致堆栈丢失。

在 Java 项目中输出包含堆栈信息的错误日志，核心是把异常对象（Throwable）完整传递给日志框架，而不是只打印 e.getMessage() 或字符串拼接。

用日志框架的异常重载方法

主流日志框架（如 SLF4J + Logback、Log4j2）都提供了接收 Throwable 参数的重载方法。这是最标准、最推荐的方式：

• SLF4J 示例：logger.error("数据库查询失败", e);
• Log4j2 示例：logger.error("文件读取异常", e);
• 避免写成：logger.error("数据库查询失败: " + e.getMessage()); —— 这会丢失堆栈

确保日志配置支持堆栈输出

即使代码传了异常，如果日志配置里用了不带 `%ex` 或 `%throwable` 的 pattern，堆栈也不会显示：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• Logback 的 logback.xml 中，pattern 应包含 %ex（如：%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%ex%n）
• Log4j2 的 log4j2.xml 中，pattern 应含 %throwable 或 %ex
• 默认配置通常已包含，但自定义 pattern 时容易遗漏

捕获后重新抛出时保留原始堆栈

不要用 new RuntimeException("xxx", e) 包装后再抛，除非有意为之；更常见的是直接抛出原异常或使用 throw e;（在 catch 块中）。若需记录日志再抛出，仍应调用 logger.error("...", e)，然后 throw e; 或 throw new XxxException("...", e); —— 构造时传入 cause 才能保留原始堆栈轨迹。

避免手动调用 e.printStackTrace()

e.printStackTrace() 输出到 System.err，无法被日志框架统一管理（如异步、分级、归档），也不受日志级别控制：

• ❌ 不要写：e.printStackTrace();
• ✅ 改为：logger.error("操作失败", e);
• 如需临时调试且不走日志，可用 e.getStackTrace() 手动格式化，但生产环境不建议

不复杂但容易忽略：传异常对象 + 配置正确 pattern，就能让堆栈稳稳落在日志里。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南