优雅结合全局异常处理与自定义异常的关键是分层明确、语义清晰、响应统一：定义抽象基类businessexception，按模块派生具体异常，用@controlleradvice分级捕获并返回结构化result，联动错误码与http状态码，增强日志可观测性。
Java 全局异常处理与自定义异常的优雅结合，核心在于“分层明确、语义清晰、响应统一”。业务逻辑不掺杂异常捕获代码，错误能精准归因，前端收到结构一致、带业务码的提示，日志里还能快速定位场景——这才是真正落地的优雅。
设计有层次的自定义异常体系
避免只建一个 BizException 通吃所有错误。应按职责分层：
- 定义抽象基类（如 BusinessException），含 errorCode 和 message，继承 RuntimeException
- 按模块或场景派生具体异常：如 UserNotFoundException（404）、InsufficientBalanceException（400）、FileUploadTooLargeException（413）
- 每个子类可预置静态错误码常量，便于调用方直接引用，也利于前后端对齐
全局处理器按类型精准拦截
使用 @ControllerAdvice + @ExceptionHandler 实现分级响应，顺序很重要：
- 先处理具体业务异常（如 @ExceptionHandler(UserNotFoundException.class)），返回 404 + 自定义消息
- 再捕获通用业务异常基类（@ExceptionHandler(BusinessException.class)），兜底返回 400 或 500，并提取 errorCode
- 最后用 @ExceptionHandler(Exception.class) 捕获未预期异常，记录完整堆栈，返回通用服务错误（如 500）
- 注意：不要把所有异常都交给最宽泛的 Exception 处理器，否则会丢失业务语义
统一响应体与错误码联动
异常信息必须通过标准格式透出，不能靠 e.getMessage() 拼接：
- 封装 Result
类，固定含 code（业务错误码，非 HTTP 状态码）、message、data - 在异常处理器中，从自定义异常实例中提取 errorCode 和 message，填充到 Result 中返回
- HTTP 状态码由处理器单独控制（如 NotFoundException 对应 404，其余 BusinessException 默认 400），与业务错误码解耦
增强可观测性与调试友好性
优雅不只是给前端看的，更是给开发者和运维用的：
- 在全局处理器中，对非业务异常（如 Exception）务必打印完整堆栈，建议用 SLF4J 的 log.error("系统异常", e)
- 对业务异常，可只记录简要日志（如 “用户ID=12345 查询失败：用户不存在”），避免刷屏
- 考虑在异常构造时注入请求 ID（如从 MDC 获取），让日志可跨链路追踪
- 禁止吞异常、禁止空 catch、禁止用异常做流程判断（比如靠 NullPointerException 判空）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
