java自定义异常不负责日志记录，需在抛出或捕获时结合slf4j等框架主动记录业务上下文；应封装orderid、userid等字段并提供tologstring()，在catch块中用占位符结构化输出，全局异常处理器补充traceid等请求信息，并通过json日志和mdc配置提升可检索性。
Java 中自定义异常本身不负责记录日志，关键在于抛出异常时或捕获异常后，主动将业务上下文信息写入日志。要记录详细的业务错误日志，需结合自定义异常的构造能力、日志框架（如 SLF4J + Logback）以及合理的日志位置设计。
在自定义异常中封装关键业务字段
让异常携带可读性强、便于排查的业务数据，而不是只依赖堆栈。例如订单场景：
- 在异常类中添加 orderId、userId、businessCode、errorMessage 等字段
- 重写 toString() 或提供 toLogString() 方法，返回结构化日志内容
- 避免在异常中直接打印日志（违反单一职责），只做信息承载
public class BusinessException extends RuntimeException {
private final String orderId;
private final Long userId;
private final String businessCode;
public BusinessException(String message, String orderId, Long userId, String businessCode) {
super(message);
this.orderId = orderId;
this.userId = userId;
this.businessCode = businessCode;
}
public String toLogString() {
return String.format("BusinessException[order=%s, user=%d, code=%s, msg=%s]",
orderId, userId, businessCode, getMessage());
}
}
在 catch 块中使用结构化日志输出
不要只写 log.error("出错了", e)，而应把异常携带的业务字段和原始异常一起记录：
- 用 SLF4J 的 {} 占位符传入业务参数，避免字符串拼接影响性能
- 确保 异常对象作为最后一个参数传入，才能正确打印堆栈
- 对敏感字段（如手机号、身份证号）做脱敏处理再记录
try {
processOrder(order);
} catch (BusinessException e) {
log.error("订单处理失败 order={} user={} code={} detail={}",
e.getOrderId(), e.getUserId(), e.getBusinessCode(), e.getMessage(), e);
}
统一异常处理层补充上下文信息
在 Spring MVC 的 @ControllerAdvice 或 WebFilter 中，可自动注入请求级上下文：
- 获取当前 traceId、requestId、客户端 IP、URI、HTTP 方法等
- 将这些信息与业务异常合并，构建完整日志事件
- 避免每个 service 层都重复获取和拼接，提升一致性和可维护性
@ExceptionHandler(BusinessException.class)
public ResponseEntity> handleBusinessException(BusinessException e, HttpServletRequest request) {
String traceId = MDC.get("traceId");
log.warn("BusinessException caught [trace={}, uri={}, method={}, {}]",
traceId, request.getRequestURI(), request.getMethod(), e.toLogString(), e);
return ResponseEntity.badRequest().body(...);
}
日志配置支持业务字段快速检索
光记录不够，还要方便查。通过日志框架配置增强可搜索性：
- 在 Logback 的 PatternLayout 中加入 MDC 字段，如
%X{traceId} %X{userId} - 使用 JSON 日志格式（如 logstash-logback-encoder），让 order_id、error_code 等成为独立字段，便于 ELK/Kibana 聚合分析
- 为不同业务模块设置独立 logger name（如
com.example.order），便于按包隔离日志
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
