在SpringBoot项目中异常处理是绕不开的话题。如果每个Controller都写一堆try-catch代码会变得臃肿不堪如果直接把异常堆栈抛给前端用户体验和系统安全都会大打折扣。真正优雅的做法是让异常处理集中化、标准化、可扩展。今天我们就来聊聊如何把SpringBoot全局异常处理做到极致。一、为什么需要全局异常处理先看一段典型的“反面教材”java复制下载GetMapping(/user/{id}) public User getUser(PathVariable Long id) { try { return userService.findById(id); } catch (UserNotFoundException e) { return null; // 或者返回一个乱七八糟的错误对象 } catch (Exception e) { e.printStackTrace(); return null; } }每个接口都这样写代码重复率极高返回格式五花八门前端无法统一处理。更严重的是异常信息可能暴露数据库结构或服务器路径带来安全隐患。二、SpringBoot的利器ControllerAdvice ExceptionHandlerSpringBoot提供了ControllerAdvice和ExceptionHandler让我们可以定义全局异常处理器。java复制下载RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(BusinessException.class) public Result? handleBusinessException(BusinessException e) { return Result.fail(e.getCode(), e.getMessage()); } ExceptionHandler(MethodArgumentNotValidException.class) public Result? handleValidException(MethodArgumentNotValidException e) { String msg e.getBindingResult().getFieldError().getDefaultMessage(); return Result.fail(400, msg); } ExceptionHandler(Exception.class) public Result? handleException(Exception e) { log.error(系统异常, e); return Result.fail(500, 系统繁忙请稍后重试); } }RestControllerAdvice相当于ControllerAdviceResponseBody返回JSON格式。这样所有Controller抛出的异常都会被这里捕获统一返回。三、统一返回格式为了让前端处理更简单我们需要定义一个统一的返回结构java复制下载Data public class ResultT { private int code; private String message; private T data; public static T ResultT success(T data) { ResultT r new Result(); r.code 200; r.message 成功; r.data data; return r; } public static T ResultT fail(int code, String message) { ResultT r new Result(); r.code code; r.message message; return r; } }所有接口都返回Result前端只需判断code即可异常和正常响应格式完全一致。四、自定义业务异常对于业务逻辑错误建议定义自己的异常体系java复制下载public class BusinessException extends RuntimeException { private final int code; public BusinessException(int code, String message) { super(message); this.code code; } public int getCode() { return code; } }在Service层直接抛出BusinessException由全局处理器统一转换为标准响应。这样业务代码干净利落不用关心HTTP状态码。五、处理参数校验异常SpringBoot的Valid注解配合NotNull、Size等可以自动校验参数。校验失败会抛出MethodArgumentNotValidException我们可以在全局处理器中捕获并提取友好提示避免返回冗长的堆栈信息。六、日志记录与监控全局异常处理不仅是返回错误还要记录日志。对于业务异常可以记录warn级别对于系统异常必须记录error级别并带上请求路径、参数、用户信息等上下文。这样排查问题时才能快速定位。java复制下载ExceptionHandler(Exception.class) public Result? handleException(HttpServletRequest request, Exception e) { log.error(请求路径{}异常{}, request.getRequestURI(), e.getMessage(), e); return Result.fail(500, 系统异常); }七、优雅到极致的细节区分HTTP状态码业务异常返回200系统异常返回500或者统一返回200由code区分根据团队规范选择。避免暴露敏感信息生产环境不要返回堆栈、SQL语句、类名等。支持国际化异常消息可以从MessageSource读取实现多语言。优先级ExceptionHandler会优先匹配最具体的异常类型最后才走Exception兜底。异步异常对于Async方法抛出的异常需要单独配置AsyncUncaughtExceptionHandler。八、总结全局异常处理看似简单却直接体现了一个项目的工程化水平。通过ControllerAdvice、自定义异常、统一返回格式、日志记录我们可以让代码更干净、接口更规范、排查更高效。记住优雅的异常处理不是消灭异常而是让异常变得可控、可读、可追踪。从今天起告别try-catch堆砌让你的SpringBoot项目真正优雅起来。