java自定义异常配合枚举类规范错误类型，核心是分离语义（错在哪）与行为（怎么报）：枚举定义错误种类、码值、提示及协议映射；异常类承载传播信息并保留技术上下文，实现解耦、可读、可统计、可映射。
Java 自定义异常配合枚举类规范错误类型，核心是把“错在哪”（语义）和“怎么报”（行为）分开：枚举专注定义错误的种类、码值、提示和协议映射；异常类专注承载并传播这些信息，同时保留技术上下文。这样做既避免硬编码散落，又让业务逻辑清晰可读、错误可统计、前端可映射。
用枚举统一定义错误码结构
枚举不是简单存个字符串或数字，而是封装完整错误元数据：
- 每个枚举项代表一个确定的业务失败场景（如 USER_LOGIN_FAILED），不可复用或模糊命名
- 字段至少包含：code（唯一标识，建议 String 格式如 "AUTH_001"）、message（默认提示语）、httpStatus（可选，用于 Web 层映射）
- 推荐实现统一接口（如 IErrorCode），强制约束 getter，方便后续扩展或框架集成
- 按模块分组命名和编号（如 USER_、ORDER_、PAY_），便于归类和搜索
异常类接收枚举实例，自动提取关键信息
自定义异常不自己拼错误码，而是通过构造函数接收枚举对象，从中获取 code 和 message：
- 继承 RuntimeException（业务异常通常是非受检的，不强制调用方处理）
- 字段声明为 private final String errorCode 和 private final String defaultMessage，确保不可变
- 构造方法示例：
public BusinessException(ErrorCode code) {
super(code.getMessage());
this.errorCode = code.getCode();
this.defaultMessage = code.getMessage();
} - 这样调用时只需传 BusinessException(ErrorCode.USER_NOT_FOUND)，干净且类型安全
支持动态参数化提示，兼顾可读性与灵活性
真实业务中提示常需带变量（如“用户 ID {0} 不存在”），枚举 message 字段可含占位符，异常类在构造时完成填充：
- 枚举中定义：USER_NOT_FOUND("USR_001", "用户 {0} 不存在")
- 异常类增加带 args 的构造函数，内部用 MessageFormat.format() 或类似工具渲染
- 调用：new BusinessException(ErrorCode.USER_NOT_FOUND, "U123456") → message 变为“用户 U123456 不存在”
- 避免把参数拼进 errorCode 字段——码必须稳定，内容才可监控、可翻译、可路由
搭配全局异常处理器，统一输出格式
枚举+异常只是定义侧，真正落地靠 @RestControllerAdvice 统一拦截并转成标准响应：
- 在 Advice 中判断异常是否为 BusinessException 类型，取出其 errorCode 和渲染后的 message
- HTTP 状态码从枚举中取 httpStatus，而非由异常类决定——协议层和业务层解耦
- 可额外注入上下文字段（如 traceId、userId），丰富日志和告警能力，不污染 message 字符串
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
