Java自定义异常携带上下文参数的核心是通过构造方法接收并保存关键业务字段（如orderId、userId），提供getter方法供日志和排查使用；推荐结合MDC实现上下文解耦，同时注意序列化兼容性。
Java 中自定义异常携带上下文参数，核心是通过构造方法接收并保存这些参数，再在异常消息或 getter 方法中使用它们。不是简单拼接字符串，而是让异常本身“记得”关键业务信息，便于排查和日志记录。
在自定义异常类中定义字段并提供构造方法
这是最直接的方式：为需要的上下文（如订单号、用户 ID、操作类型）声明私有字段，并在构造器中赋值。建议至少保留一个带 String message 和上下文参数的构造器，同时调用父类（Exception 或 RuntimeException）的含消息构造器，保证标准行为。
例如：
public class OrderProcessingException extends RuntimeException {
private final String orderId;
private final Long userId;
private final String operation;
public OrderProcessingException(String message, String orderId, Long userId, String operation) {
super(message + " [Order:" + orderId + ", User:" + userId + ", Op:" + operation + "]");
this.orderId = orderId;
this.userId = userId;
this.operation = operation;
}
// 提供 getter，方便外部提取上下文
public String getOrderId() { return orderId; }
public Long getUserId() { return userId; }
public String getOperation() { return operation; }
}
重写 getLocalizedMessage() 或添加专用格式化方法
如果不想把上下文硬编码进主消息（影响可读性或国际化），可以重写 getLocalizedMessage()，或新增如 toLogMessage() 方法，按需组装结构化日志内容。
立即学习“Java免费学习笔记（深入）”；
- 避免覆盖
getMessage()—— 它应保持简洁语义，比如“库存不足”，而不是堆砌参数 -
getLocalizedMessage()可返回带上下文的详情，供日志框架（如 Logback）自动采集 - 额外提供
getContextMap()返回Map<String, Object>，方便结构化日志（如 JSON）直接序列化
配合日志框架自动提取上下文（推荐实践）
现代日志框架（如 Logback + MDC，或 Log4j2 的 ThreadContext）支持在线程上下文中绑定变量。抛异常前把关键参数写入 MDC，日志输出模板里引用即可，异常类本身无需存储——解耦更干净。
示例（使用 SLF4J + Logback）：
MDC.put("orderId", "ORD-2024-789");
MDC.put("userId", "12345");
try {
processOrder(...);
} catch (Exception e) {
throw new OrderProcessingException("Failed to process order", e);
}
// 日志配置 %X{orderId} %X{userId} 就能自动打印上下文
这种方式不污染异常模型，适合跨多层调用、上下文动态变化的场景。
注意 Throwable 的序列化与框架兼容性
如果异常需远程传输（如 Dubbo、gRPC）或持久化，确保所有自定义字段可序列化，并考虑：
- 添加
private static final long serialVersionUID = 1L; - 避免在字段中存不可序列化的对象（如
ThreadLocal、连接池实例） - Spring 等框架可能通过反射读取异常字段用于错误响应，命名建议用标准驼峰且提供 public getter
