java自定义异常应通过private final字段结构化承载订单号、用户id等上下文，重写tostring()显式拼接字段，提供多参构造方法并显式调用super()，声明serialversionuid，全局处理器需调用getter而非getmessage()。
Java 自定义异常携带额外上下文数据，核心不是往 message 里拼字符串，而是用结构化字段显式承载关键业务信息，并确保这些字段在日志、调试、序列化等场景中真正可见、可用。
用 final 字段封装上下文，不依赖 message
把订单号、用户ID、错误码、traceId 这类信息声明为 private final 成员变量，而不是塞进构造函数的 message 参数里。这样既能保证不可变性，又便于后续统一访问和扩展。
- 字段类型选可序列化的基础类型（
String、Long、Integer等），避免放HttpServletRequest或大对象 - 每个字段配 public getter 方法，供日志、监控、全局异常处理器调用
- 不要在字段里存敏感数据（如密码、token），也不建议存完整请求体
重写 toString()，让日志自动显示上下文
SLF4J、Logback 等主流日志框架默认只调用 toString() 打印异常，而 Throwable 的默认实现只输出类名 + getMessage()，完全不包含你加的字段。所以必须重写：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 在
toString()中调用super.toString()保留原始堆栈标识 - 手动拼接上下文字段，例如：
"; orderId=" + orderId + "; userId=" + userId + "; code=" + errorCode - 对可能为 null 的字段做安全判断（如
Objects.toString(orderId, "N/A")），避免空指针
提供多参构造方法，覆盖常见调用场景
让使用者能按需传入上下文，同时兼容标准异常用法：
-
MyException(String message)：基础用法，内部仍调用super(message) -
MyException(String message, String orderId, Long userId)：主业务场景常用 -
MyException(String message, Throwable cause, int errorCode)：支持异常链 + 业务码 - 所有构造方法末尾都需显式调用
super(...)，确保父类堆栈和 cause 正常传递
补充关键细节，避免踩坑
光加字段还不够，几个容易忽略但影响实际效果的点：
- 显式声明
private static final long serialVersionUID = 1L;，否则反序列化时上下文字段会丢失 - 如果用到 Builder 模式，确保构建过程不破坏 final 语义（如用私有构造 + 静态 builder 方法）
- 全局异常处理器（如
@RestControllerAdvice）中，别只取e.getMessage()，应组合e.getOrderId()、e.getErrorCode()等字段打结构化日志 - 错误码建议用枚举管理，与异常类强绑定，避免散落在各处的字符串或数字硬编码
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
