Java枚举类本身不能直接抛出异常，但可通过定义统一错误枚举（含code、message、httpStatus等字段）与可携带枚举信息的自定义异常类（如BizException）结合，实现全链路错误提示的规范化管理。
Java 枚举类本身不能直接抛出异常，但可以通过枚举统一定义错误码、错误消息、HTTP 状态码等元信息，并结合自定义异常类实现全链路错误提示的规范化管理。核心思路是：枚举承载错误元数据，异常类封装可抛出行为，调用方按需构造并抛出。
定义统一错误枚举（含业务码、提示语、状态码）
创建一个实现接口的枚举，明确每个错误场景的唯一标识和语义化描述：
- 每个枚举项对应一个具体业务错误（如参数校验失败、资源不存在、权限不足）
- 字段建议包含：code（String 或 int 类型的唯一错误码）、message（用户/前端可见的提示文案）、httpStatus（对应 HTTP 响应状态，如 HttpStatus.BAD_REQUEST）
- 可额外添加 level（ERROR/WARN）、logTemplate（便于日志记录的结构化模板）等扩展字段
示例：
public enum BizError implements ErrorCode {
PARAM_INVALID("B001", "请求参数不合法", HttpStatus.BAD_REQUEST),
USER_NOT_FOUND("B002", "用户不存在", HttpStatus.NOT_FOUND),
INSUFFICIENT_PERMISSION("B003", "权限不足", HttpStatus.FORBIDDEN);
private final String code;
private final String message;
private final HttpStatus httpStatus;
BizError(String code, String message, HttpStatus httpStatus) {
this.code = code;
this.message = message;
this.httpStatus = httpStatus;
}
// 实现接口方法（如 getCode()、getMessage()、getHttpStatus()）
}
设计可携带枚举信息的自定义异常类
该异常需持有枚举实例，支持运行时动态填充上下文变量（如用户名、订单号），让提示更精准：
立即学习“Java免费学习笔记（深入）”；
- 构造函数接收 BizError 枚举 + 可变参数（用于格式化 message 中的占位符）
- 重写 getMessage()，内部调用
String.format(errorEnum.getMessage(), args) - 提供 getCode()、getHttpStatus() 等便捷方法，方便全局异常处理器提取
示例：
public class BizException extends RuntimeException {
private final BizError error;
private final Object[] args;
public BizException(BizError error, Object... args) {
super(String.format(error.getMessage(), args));
this.error = error;
this.args = args;
}
public String getCode() { return error.getCode(); }
public HttpStatus getHttpStatus() { return error.getHttpStatus(); }
// 其他 getter...
}
在业务逻辑中统一抛出（避免硬编码字符串）
所有业务异常都通过枚举+异常类组合抛出，杜绝散落在各处的 new RuntimeException("xxx")：
- 参数校验失败 →
throw new BizException(BizError.PARAM_INVALID, "username", "不能为空") - 查不到用户 →
throw new BizException(BizError.USER_NOT_FOUND, userId) - 权限检查不通过 →
throw new BizException(BizError.INSUFFICIENT_PERMISSION)
这样 message 最终会变成 “用户不存在（ID: 1001）”，前端拿到的是结构化的 {"code":"B002","message":"用户不存在（ID: 1001）"}。
全局异常处理器统一响应格式
Spring Boot 中用 @ControllerAdvice 拦截 BizException，输出标准化 JSON：
- 提取枚举中的 code、message、httpStatus
- 可补充 traceId（链路追踪 ID）便于问题定位
- 对非 BizException 的其他异常（如 NullPointerException）做兜底处理，避免暴露堆栈
响应体示例：
{
"code": "B002",
"message": "用户不存在（ID: 1001）",
"timestamp": "2024-05-20T10:30:45.123Z",
"traceId": "abc123"
} 
