java统一异常处理核心是@controlleradvice配合@exceptionhandler，结合统一响应格式result和分级日志记录，实现异常拦截、分类处理与友好返回。
Java中统一处理异常的核心是用@ControllerAdvice配合@ExceptionHandler，再结合统一响应格式和日志记录，让所有控制器的运行时异常都能被拦截、分类、友好返回，避免堆栈暴露给前端。
定义全局异常处理器类
新建一个类，加上@ControllerAdvice注解，它会自动作用于所有@Controller（包括@RestController）：
- 类上加@ControllerAdvice，可指定包路径（如basePackages = "com.example.controller"）缩小生效范围
- 方法上用@ExceptionHandler声明能捕获的异常类型，支持多个异常类，如@ExceptionHandler({NullPointerException.class, IllegalArgumentException.class})
- 方法参数可直接写异常对象、HttpServletRequest、HttpServletResponse等，Spring会自动注入
设计统一响应结构
避免每个接口返回Map或Object，建议封装一个标准响应体，比如：
-
Result
：含code（如200成功、500系统异常、400参数错误）、msg（提示语）、data（业务数据） - 异常处理器里不再return new ModelAndView，而是return Result.fail("操作失败", e.getMessage())
- 前端统一判断code，无需解析不同字段，也便于后续做国际化或错误码映射
分层捕获与日志记录
不是所有异常都该被全局处理器“吞掉”，要区分场景：
立即学习“Java免费学习笔记（深入）”；
- 业务异常（如UserNotExistException）——建议自定义异常并主动throw，由@ExceptionHandler精准捕获，返回400或特定code
- 系统异常（如NullPointerException、SQLException）——兜底捕获Exception，记录ERROR日志（含堆栈），返回500 + 友好提示（如“服务暂时不可用”）
- 使用log.error("全局异常捕获", e)，确保堆栈完整入库，方便排查
补充：WebMvcConfigurer与异常页面（可选）
如果项目还用JSP/Thymeleaf渲染页面，可额外配置：
- 实现WebMvcConfigurer，重写configureHandlerExceptionResolvers()，添加SimpleMappingExceptionResolver
- 为不同异常映射到不同错误页（如404.html、500.html），但REST API项目通常不需要
- 注意：@ControllerAdvice优先级高于SimpleMappingExceptionResolver，两者不冲突，前者更灵活
基本上就这些。不复杂但容易忽略的是日志记录粒度和响应code的合理性——别让500满天飞，也别把业务错误全塞进200里返回错误信息。
