Java Web中需通过自定义异常类、HTTP状态码枚举和@ControllerAdvice全局处理器三者协同，实现业务异常到标准HTTP状态码及统一JSON响应体的自动映射。
Java Web 开发中，自定义异常与 HTTP 状态码的映射不是简单地“抛出异常就返回某个码”，而是需要结合异常类设计、全局异常处理器和响应结构三者协同完成。核心目标是：让每个业务异常携带明确的状态码语义，并在 Web 层自动转为对应的 HTTP 响应状态。
定义带 HTTP 状态码的错误码枚举
错误码本身应直接关联标准 HTTP 状态，避免硬编码或后期拼接。推荐用字符串码（如 USER_NOT_FOUND）+ 数字码（如 404）+ 提示语三元组合：
- 枚举实现统一接口（如 IErrorCode），强制提供 getCode()、getMsg()、getHttpStatus()
- 按模块分组，例如：USER_001（404）、ORDER_INVALID（400）、PAY_TIMEOUT（500）
- 状态码选型要符合语义：参数错误用 400，未登录用 401，无权限用 403，资源不存在用 404，服务异常用 500
自定义异常类绑定状态码
异常实例需能携带并暴露状态码，而不是仅靠枚举静态值间接获取：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 继承 RuntimeException（非受检异常，适合业务流程中断）
- 构造时接收枚举项或直接传入 HttpStatus，内部保存为 httpStatus 字段
- 提供 getHttpStatus() 方法，供后续处理器读取
- 支持动态消息填充（如 String.format(msg, args)），但状态码保持不变
用 @ControllerAdvice 统一映射到 HTTP 响应
Spring Boot 中最常用且推荐的方式是全局异常处理器 + ResponseEntity：
立即学习“Java免费学习笔记（深入）”；
- 使用 @ExceptionHandler 捕获自定义异常（如 BizException）
- 从异常中提取 httpStatus 和业务错误码、提示语
- 返回 ResponseEntity<CustomResponse>，其中 status() 显式设为该 HTTP 状态码
- 不依赖 response.setStatus() 手动设置，避免与 Spring 的响应生命周期冲突
配合统一响应体确保前端可解析
状态码只是 HTTP 头的一部分，前端真正消费的是整个 JSON 响应体。因此需保证：
- 响应体结构统一，包含 code（业务码）、message（提示）、data（可选）
- 即使 HTTP 状态是 400，响应体仍含 code: 40001 和 message: "用户名已存在"，便于前端细粒度处理
- 避免只靠 HTTP 状态码做逻辑分支——400 可能对应参数错、权限错、校验错等多种场景，必须靠业务码区分
