Java异常处理与日志框架结合的核心是catch中用logger.error("描述", args..., e)传入Throwable，确保完整堆栈和业务上下文被记录，避免拼接字符串、printStackTrace或空catch；Logback需配置%ex输出堆栈。
Java 中异常处理与日志框架结合，核心是在 catch 块中用日志器记录异常的完整堆栈信息，而不是仅打印消息或忽略异常。关键在于保留 Throwable 对象传给日志方法，让日志框架自动输出堆栈跟踪（stack trace），这对排查问题至关重要。
使用 SLF4J + Logback 记录异常（推荐组合）
SLF4J 是日志门面，Logback 是原生实现，两者配合最简洁高效：
- 在
catch中直接传入异常对象：
logger.error("数据库查询失败，用户ID={}", userId, e); - SLF4J 会自动识别第三个参数为
Throwable，并将其堆栈写入日志 —— 这比手动调用e.printStackTrace()或拼接e.getMessage()更可靠、更结构化。 - 确保日志级别设为
ERROR（不是INFO或WARN），避免错误被淹没。
避免常见错误写法
这些做法会丢失关键诊断信息：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- logger.error("发生异常：" + e.getMessage()); → 无堆栈，无法定位出错行
- e.printStackTrace(); → 输出到控制台，不进日志文件，难统一收集
- logger.error("操作失败", e); → 没有描述性消息，上下文缺失（如哪个用户、什么操作）
- 空 catch 块（catch (Exception e) { }）→ 异常彻底消失，系统静默故障
增强可追溯性的实用技巧
除了记录异常本身，补充业务上下文能大幅提升排障效率：
立即学习“Java免费学习笔记（深入）”；
- 在日志消息中嵌入关键变量（如 ID、状态码、请求路径），用占位符避免字符串拼接：
logger.error("支付回调验签失败，订单号={}，签名={}", orderNo, signature, e); - 对受检异常（Checked Exception）且确定可恢复时，可降级记录为
WARN并附说明；不可恢复或运行时异常（RuntimeException）一律用ERROR。 - 在全局异常处理器（如 Spring 的
@ControllerAdvice）中统一捕获未处理异常，确保所有 Web 请求异常都被记录，避免遗漏。
Logback 配置要点（确保堆栈可见）
检查 logback-spring.xml 中的 pattern 是否包含 %ex 或 %xEx：
- <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n%ex</pattern>
-
%ex表示输出完整异常堆栈；若省略，即使代码中传了异常对象，日志里也只显示消息不显示堆栈。 - 生产环境建议启用异步日志（
AsyncAppender），避免日志 I/O 拖慢异常处理流程。
