Java自定义异常应封装订单号、用户ID等业务字段并设为final，重写toLogString()；统一用@ControllerAdvice捕获，在@ExceptionHandler中通过SLF4J占位符输出结构化日志，避免重复记录，异步场景需手动传递MDC。
Java 中自定义异常记录特有业务日志，核心是把关键业务上下文（如订单号、用户ID、操作类型）在抛出异常时一并带上，并在统一异常处理处输出结构化日志，而不是仅打印堆栈。
在自定义异常中封装业务字段
继承 RuntimeException 或 Exception，添加业务相关属性（如 orderId、userId、businessCode），并提供构造方法传入这些值。避免把日志逻辑塞进异常类本身——异常只负责“携带信息”，不负责“打印日志”。
- 定义字段：用
final修饰，确保不可变 - 重写
toString()或新增toLogString()方法，方便日志组件调用 - 示例：new OrderValidationException("ORDER_INVALID", "ORD2024001", 1001L)
在统一异常处理器中提取并记录日志
使用 @ControllerAdvice + @ExceptionHandler 捕获自定义异常，在这里做日志记录。利用 SLF4J 的 logger.error(String, Object...) 占位符方式，把业务字段作为参数传入，确保日志可检索、易解析。
- 不要只写
logger.error("订单校验失败", ex)—— 丢失上下文 - 推荐写法：
logger.error("订单校验失败 | 订单号:{} | 用户ID:{} | 错误码:{}", ex.getOrderId(), ex.getUserId(), ex.getBusinessCode(), ex) - 若用 Logback，可配合
%X{traceId}等 MDC 字段补充链路追踪信息
避免日志重复或遗漏的关键点
业务代码中抛出异常前，不要提前打日志；统一由异常处理器输出——否则同一错误可能被记两次。同时确保所有自定义异常都经过该处理器（检查是否被 try-catch 吞掉、或类型未被 @ExceptionHandler 覆盖）。
立即学习“Java免费学习笔记（深入）”；
- 禁止在 service 层
log.warn("库存不足")后再 throw 异常 - 检查 @ExceptionHandler 是否声明了正确的异常类型（如用了
BaseBusinessException.class但子类未被包含） - 对异步线程、定时任务中的异常，需单独配置异常捕获和日志逻辑
进阶：结合 AOP 自动注入日志上下文
对于高频业务场景（如支付、下单），可用 @Around 切面自动提取当前请求的业务标识（从参数、ThreadLocal 或 JWT 中获取），绑定到 MDC，并在异常抛出时自动附带。这样即使忘记手动传参，日志里仍有基础上下文。
- MDC.put("orderId", extractOrderId(joinPoint))
- 异常处理器中直接用
logger.error("业务异常 | {}", MDC.get("orderId"), ex) - 注意 MDC 在异步或线程池中需手动传递，避免丢失
