java自定义异常需重写构造函数链并显式调用super(message/cause)，字段用final修饰；必须重写tostring()（含super.tostring()）和getmessage()以显示上下文字段，显式声明serialversionuid并确保字段可序列化，日志中才可见traceid等信息。
Java自定义异常怎么带上下文字段
直接加字段就行，但必须重写构造函数链，否则 getMessage() 和日志打印时看不到这些数据。Java 异常本身不自动序列化新增字段，也不参与默认字符串拼接。
- 所有带业务字段的构造函数，最后都要调用
super(message)或super(message, cause)，保证父类异常信息不丢失 - 推荐至少提供三个构造函数：无参、仅
message、message + cause，再额外加含上下文字段的版本（如String message, String traceId, int errorCode） - 字段建议用
final修饰，避免异常抛出后被意外修改
toString() 和 getMessage() 不显示自定义字段怎么办
因为 Throwable.toString() 只拼接类名 + getMessage()，而后者默认只返回构造时传入的字符串，完全不管你的 traceId 或 userId 字段。
- 必须重写
getMessage()，把上下文字段拼进去（注意别 null 指针） - 更稳妥的做法是重写
toString()，但要保留父类逻辑：super.toString() + "; traceId=" + traceId + "; errorCode=" + errorCode - 如果用了 SLF4J，日志框架通常只调
toString()，所以这里补全最关键
序列化自定义异常时字段丢失
Java 序列化默认会跳过未显式声明 serialVersionUID 的类，且若父类没实现 Serializable，子类字段可能无法反序列化——但 Exception 其实实现了，问题出在字段访问上。
- 确保自定义异常类显式声明
private static final long serialVersionUID = 1L; - 所有上下文字段必须是可序列化的类型（如
String、Integer），避免放ThreadLocal或Connection这类对象 - 如果字段可能为 null，序列化前不做判空处理，反序列化后就是 null，别指望它自动初始化
Logback/Log4j 打印异常时不显示上下文字段
日志框架默认只调用 toString()，不会反射读取你的私有字段。即使你加了 getter，不重写 toString() 或 getMessage()，日志里照样看不到 traceId。
立即学习“Java免费学习笔记（深入）”；
- 最简方案：重写
toString()，拼接关键字段，控制长度（避免日志爆炸） - 进阶方案：写个
ThrowableProxy插件（Logback）或PatternLayout自定义转换器，但多数场景没必要 - 警惕 JSON 日志：如果用
logstash-logback-encoder，它默认不包含自定义字段，得配includeContext=true并确保字段有 public getter
真正麻烦的不是加字段，而是让整个链路——从 throw 到 catch 再到日志落地——都认得清这些字段。漏掉任何一个环节，比如忘了重写 toString()，或者序列化时字段类型不对，上下文就断了。
