用static内部类封装错误上下文可避免内存泄漏、支持独立实例化且语义清晰；其典型结构为异常类+静态Context类，含Builder模式、不可变字段及toString增强日志可观测性，必要时实现Serializable以支持跨服务传递。
在 Java 自定义异常体系中，用静态内部类封装错误上下文是一种轻量、高内聚的设计方式。它不依赖外部类实例，避免内存泄漏风险，又能自然归属到异常类型下，提升语义清晰度和调用便利性。
为什么用 static class 而不是普通内部类
非静态内部类隐式持有外部类引用，若异常对象长期存活（如被日志系统缓存、异步上报），可能导致外部类实例无法回收。而 static 内部类无此引用，适合承载纯数据结构的上下文信息，比如请求 ID、用户标识、入参快照等。
- 不增加异常对象的 GC 压力
- 可独立实例化（
MyException.Context.of(...)） - 天然属于异常类命名空间，避免全局命名污染
典型结构：异常类 + 静态 Context 类
以下是一个生产可用的模式：
public class BizException extends RuntimeException {
private final Context context;
public BizException(String message, Context context) {
super(message);
this.context = context;
}
public Context getContext() {
return context;
}
// 静态内部类：只含字段、构造器、构建器方法
public static class Context {
private final String traceId;
private final String userId;
private final Map<String, Object> params;
private Context(Builder builder) {
this.traceId = builder.traceId;
this.userId = builder.userId;
this.params = Collections.unmodifiableMap(new HashMap<>(builder.params));
}
public static Builder of() {
return new Builder();
}
public static class Builder {
private String traceId;
private String userId;
private final Map<String, Object> params = new HashMap<>();
public Builder traceId(String traceId) { this.traceId = traceId; return this; }
public Builder userId(String userId) { this.userId = userId; return this; }
public Builder param(String key, Object value) { this.params.put(key, value); return this; }
public Context build() {
return new Context(this);
}
}
// 提供便捷访问方法（按需添加）
public String getTraceId() { return traceId; }
public String getUserId() { return userId; }
public Map<String, Object> getParams() { return params; }
}
}
使用时简洁明确：
立即学习“Java免费学习笔记（深入）”；
throw new BizException("库存不足",
BizException.Context.of()
.traceId("req-abc123")
.userId("U98765")
.param("skuId", 1001)
.param("required", 5)
.build()
);
配合 toString / log 输出增强可观测性
可在 Context 中重写 toString()，让日志自动打印结构化上下文：
@Override
public String toString() {
return String.format("Context{traceId='%s', userId='%s', params=%s}",
traceId, userId, params);
}
这样在 SLF4J 日志中：log.error("业务异常", ex); 就能连带输出上下文，无需额外拼接。
进阶：支持序列化与跨服务传递
如果异常需经 RPC 或消息队列传播（如 Dubbo、Spring Cloud），确保 Context 实现 Serializable，并显式定义 serialVersionUID：
public static class Context implements Serializable {
private static final long serialVersionUID = 1L;
// ... 字段同上
}
注意：避免在 Context 中存放不可序列化对象（如 ThreadLocal、连接句柄等），否则反序列化会失败。
