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：

• 使用 @ExceptionHandler 捕获自定义异常（如 BizException）
• 从异常中提取 httpStatus 和业务错误码、提示语
• 返回 ResponseEntity，其中 status() 显式设为该 HTTP 状态码
• 不依赖 response.setStatus() 手动设置，避免与 Spring 的响应生命周期冲突

配合统一响应体确保前端可解析

状态码只是 HTTP 头的一部分，前端真正消费的是整个 JSON 响应体。因此需保证：

• 响应体结构统一，包含 code（业务码）、message（提示）、data（可选）
• 即使 HTTP 状态是 400，响应体仍含 code: 40001 和 message: "用户名已存在"，便于前端细粒度处理
• 避免只靠 HTTP 状态码做逻辑分支——400 可能对应参数错、权限错、校验错等多种场景，必须靠业务码区分

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南