java异常日志需完整记录：代码中用logger.error("msg", e)传异常对象，配置中日志pattern添加%ex等堆栈占位符，并通过mdc注入traceid、userid等上下文，禁用e.printstacktrace()。
Java 中异常信息要完整记录到日志文件中，核心是两件事：代码里正确传参，配置里确保堆栈能输出。光写 logger.error("xxx", e) 不够，如果日志格式没配对，堆栈照样不落地。
必须把异常对象作为独立参数传入
SLF4J、Logback、Log4j2 都支持在 error()、warn() 等方法中把 Throwable 当作最后一个参数。框架会自动识别并展开完整堆栈，包括嵌套异常（Caused by）和抑制异常（Suppressed）。
- ✅ 正确：
logger.error("订单支付失败,订单号:{}", orderNo, e) - ❌ 错误：
logger.error("订单支付失败:" + e.getMessage())→ 只有文字，无堆栈 - ❌ 错误：
logger.error(e)→ 没业务消息，上下文缺失 - ❌ 错误：
logger.error("失败", e.getMessage())→ 第三个参数不是Throwable，堆栈被忽略
日志配置里要启用堆栈输出字段
即使代码传对了，如果日志 pattern 里没声明堆栈占位符，日志文件里依然看不到堆栈。
- Logback（
logback.xml）需包含%ex或%xEx：%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%ex%n - Log4j2（
log4j2.xml）需包含%throwable或%ex：%d{HH:mm:ss.SSS} [%t] %-5level %c{36} - %m%ex%n - 缺了
%ex类字段，哪怕e传得再规范，日志里也只有一行错误消息
补全业务上下文，别只靠异常本身
“NullPointerException” 单独出现毫无价值。必须绑定请求 ID、用户 ID、操作类型等，才能快速定位问题场景。
- 用 MDC 注入线程级上下文：
MDC.put("traceId", tid)、MDC.put("userId", userId) - 日志 pattern 中加入
%X{traceId}和%X{userId}，让每条日志自带标识 - catch 块中优先使用占位符传参：
logger.error("支付回调验签失败, traceId:{}, userId:{}", tid, userId, e) - 避免字符串拼接敏感信息，如
"密码:" + user.getPassword()→ 改为"密码已脱敏"或统一过滤
别用 e.printStackTrace() 替代日志
它直接输出到 System.err，不走日志框架，无法归档、切分、异步写入，容器环境还可能被丢弃。生产环境等于“静默失败”。
- 不进日志系统 → ELK 查不到、告警收不到、磁盘空间不受控
- 无业务上下文 → 不知道是哪个请求、哪个用户触发的
- 不能和
MDC结合 → 追踪链路断裂 - 高频异常时容易拖慢服务甚至撑爆标准错误流
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
