Spring Boot全局异常处理需构建“分层拦截+精准响应+安全闭环”体系：业务、校验、系统、HTTP语义异常分层处理；响应含traceId、语义化errorCode、环境差异化堆栈；联动ResponseBodyAdvice、熔断器、AOP增强可观测性与健壮性。
学Spring Boot全局异常高级进阶技巧，核心不是堆砌注解，而是建立“分层拦截 + 精准响应 + 安全闭环”的思维。下面这几个关键方向，踩中真实项目中的高频痛点，掌握后能直接提升代码健壮性和协作效率。
构建分层异常体系，避免一把抓
别再用@ExceptionHandler(Exception.class)兜底所有异常。实际项目里，异常必须分级：
-
业务异常（如
UserNotFoundException、InsufficientBalanceException）：由业务逻辑主动抛出，带明确code和msg，前端可直接提示或跳转 -
校验异常（
MethodArgumentNotValidException、ConstraintViolationException）：参数校验失败专用，提取字段级错误信息（如“phone: 手机号格式不正确”） -
系统异常（
SQLException、RedisConnectionException）：底层故障，统一降级为500，不暴露堆栈，但日志中完整记录 -
HTTP语义异常（
HttpRequestMethodNotSupportedException、HttpMediaTypeNotAcceptableException）：交由ResponseEntityExceptionHandler继承处理，保持标准HTTP语义
让异常响应真正“可读、可定位、可联动”
返回给前端的JSON不能只有{"code":500,"msg":"系统错误"}。高级做法要包含：
- 加一个唯一
traceId字段，与日志系统（如Logback+MDC）打通，前端报错时提供traceId，后端1秒查到完整链路日志 - 对业务异常返回
errorCode（如"USER_NOT_FOUND"），比数字码更易维护；系统异常返回泛化code（如"SYS_DB_ERROR"），方便监控告警按码聚合 - 在开发环境返回简要堆栈片段（如
e.getStackTrace()[0].toString()），生产环境则完全隐藏——用@Profile("dev")控制
把异常处理嵌入整个请求生命周期
高级技巧不止于@ExceptionHandler，还要联动其他环节：
- 用
@ControllerAdvice配合ResponseBodyAdvice，自动包装所有成功响应为Result.success(data)，实现“成功也统一”，避免前端反复判断data是否存在 - 在异常处理器里调用熔断器（如Sentinel或Resilience4j）的
tryEnter()，对高频失败接口自动触发降级 - 结合Spring AOP，在异常捕获前后记录耗时、入参、IP、User-Agent，生成结构化审计日志，用于安全分析
实战避坑：这些细节决定成败
很多团队卡在“能用”但“不好用”，问题常出在细节：
- 自定义异常类务必继承
RuntimeException，否则事务可能不回滚（除非显式配置@Transactional(rollbackFor = XxxException.class)） -
@RestControllerAdvice默认只拦截@RestController，如果项目混用@Controller返回页面，需额外加@ControllerAdvice+@ResponseBody组合或改用@ControllerAdvice配ModelAndView - 多个
@ExceptionHandler方法匹配同一异常时，Spring按方法声明顺序执行，把更具体的异常（如ValidationException）写在前面，通用的（如Exception）放最后
