使用@ControllerAdvice和@ExceptionHandler实现全局异常处理,可统一捕获异常并返回结构化信息,结合自定义异常类和ErrorResponse提升可读性与用户体验。

在Java应用中,尤其是Web项目如Spring Boot,实现全局异常处理能有效提升代码的可维护性和用户体验。通过统一捕获和处理异常,避免重复的try-catch代码,同时返回结构化的错误信息。
使用@ControllerAdvice和@ExceptionHandler
这是Spring中最常用的全局异常处理方式。@ControllerAdvice 注解的类会拦截所有控制器抛出的异常,配合 @ExceptionHandler 可以针对不同异常类型定义处理逻辑。
示例: ```java @ControllerAdvice public class GlobalExceptionHandler {@ExceptionHandler(NullPointerException.class) public ResponseEntityhandleNullPointer(NullPointerException e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) .body("发生了空指针异常:" + e.getMessage()); } @ExceptionHandler(IllegalArgumentException.class) public ResponseEntity handleIllegalArgument(IllegalArgumentException e) { return ResponseEntity.status(HttpStatus.BAD_REQUEST) .body("参数错误:" + e.getMessage()); } @ExceptionHandler(Exception.class) public ResponseEntity handleGeneralException(Exception e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) .body("服务器内部错误:" + e.getMessage()); }
}
上述代码会捕获整个应用中未处理的指定异常,并返回友好的响应内容。
立即学习“Java免费学习笔记(深入)”;
自定义异常类增强可读性
为了更精确地控制业务异常,建议定义自己的异常类。
```java public class BusinessException extends RuntimeException { public BusinessException(String message) { super(message); } }
在业务逻辑中抛出:
```java if (user == null) { throw new BusinessException("用户不存在"); } ```然后在 GlobalExceptionHandler 中添加对应处理方法:
```java @ExceptionHandler(BusinessException.class) public ResponseEntity其中 ErrorResponse 是一个标准的错误响应DTO,包含时间、状态码、提示信息等字段。
结合ResponseStatus注解简化处理
对于某些自定义异常,可以直接使用 @ResponseStatus 指定HTTP状态码,减少在ExceptionHandler中的配置。
```java @ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "用户未找到") public class UserNotFoundException extends RuntimeException { public UserNotFoundException(String message) { super(message); } } ```当该异常被抛出时,Spring会自动返回404状态码和指定原因。
日志记录与监控
全局异常处理不仅是返回错误信息,还应记录日志以便排查问题。
```java @ExceptionHandler(Exception.class) public ResponseEntityErrorResponse error = new ErrorResponse(
System.currentTimeMillis(),
HttpStatus.INTERNAL_SERVER_ERROR.value(),
"系统繁忙,请稍后重试"
);
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);}
可以集成SLF4J + Logback或Log4j2进行日志输出,必要时还可接入APM工具做异常追踪。
基本上就这些。合理使用@ControllerAdvice和自定义异常,能让Java项目的异常处理更清晰、统一。










