@controlleradvice统一捕获web异常需搭配@responsebody或直接用@restcontrolleradvice，按异常类型分层处理：先校验异常、再系统异常、最后兜底exception，配合自定义businessexception实现业务语义清晰，返回结构须与正常接口一致的result.fail()。
用 @ControllerAdvice 统一捕获 Web 错误，核心是把所有控制器层抛出的异常集中拦截、格式化、返回标准响应，不侵入业务代码。
必须加 @ResponseBody 或用 @RestControllerAdvice
如果只写 @ControllerAdvice，Spring 默认尝试走视图解析（比如跳转 error.jsp），会报 Circular view path 错误。解决方式有两种：
-
@ControllerAdvice + @ResponseBody组合使用 - 直接用
@RestControllerAdvice（推荐），它等价于两者合体，自动返回 JSON
按异常类型分层处理，别只捕一个 Exception.class
捕获太宽泛的 Exception.class 容易掩盖具体问题，建议按优先级从细到粗排列：
- 先处理参数校验异常：
@ExceptionHandler(MethodArgumentNotValidException.class)，提取 BindingResult 中的错误字段和提示 - 再处理空指针、数字格式、SQL 等系统异常，分别返回不同 code 和 msg
- 最后兜底捕获
Exception.class，记录日志并返回通用服务异常
配合自定义业务异常，让错误语义更清晰
系统异常反映技术问题，业务异常反映逻辑规则不满足（如“余额不足”“用户已存在”）。定义一个继承 RuntimeException 的 BusinessException，带 code 和 msg 字段：
- 在 service 层主动
throw new BusinessException(4001, "库存不足") - 在全局处理器里用
@ExceptionHandler(BusinessException.class)单独捕获，直接映射到 Result 的 code/msg
确保返回结构和正常接口完全一致
前端只认一种格式，异常响应必须和 success() 返回的 Result 结构对齐：
- 统一用
Result.fail(code, msg)构造失败响应 - 不要在异常处理器里返回 Map、String 或 ModelAndView（除非明确要跳转页面）
- 如果用了 Lombok 的
@Data，记得给Result加无参构造，避免 Jackson 反序列化失败
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
