各位粉丝朋友大家好呀，这个周末好累，一边遛娃，一边准备下周的知识分享，感谢杭州的雨给了我一整上午的时间来梳理总结。
在Spring Boot应用中，异常处理是一个重要的环节。良好的异常处理机制能够确保应用的健壮性，提升用户体验，并有助于开发者快速定位问题。
一、为什么需要统一异常处理
在Web应用中，异常处理通常涉及多个层面：业务逻辑异常、数据访问异常、系统异常等。如果没有统一的异常处理机制，每个控制器（Controller）可能都需要单独处理这些异常，导致代码冗余且难以维护。统一异常处理可以将异常处理逻辑集中化，提高代码的可读性和可维护性。
二、Spring Boot中的统一异常处理实现
Spring Boot提供了多种实现统一异常处理的方式，其中比较常用的是使用@ControllerAdvice和@ExceptionHandler注解。
1、定义全局异常处理器
首先，我们需要创建一个全局异常处理器类，并使用@ControllerAdvice注解进行标注。这个类将负责处理应用中抛出的所有异常。
@ControllerAdvice
public class GlobalExceptionHandler {
// 定义处理特定异常的方法
@ExceptionHandler(value = CustomException.class)
@ResponseBody
public ResponseEntity<ErrorResponse> handleCustomException(CustomException e) {
ErrorResponse errorResponse = new ErrorResponse(e.getMessage());
return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
}
// 处理其他未捕获的异常
@ExceptionHandler(value = Exception.class)
@ResponseBody
public ResponseEntity<ErrorResponse> handleGeneralException(Exception e) {
ErrorResponse errorResponse = new ErrorResponse("发生未知错误，请联系管理员");
return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
}
}
在上面的代码中，我们定义了两个异常处理方法。handleCustomException用于处理自定义异常CustomException，而handleGeneralException则用于处理其他所有类型的异常。每个方法都返回一个ResponseEntity对象，其中包含了异常信息和相应的HTTP状态码。
创建自定义异常类
为了更好地管理业务逻辑异常，我们可以创建自定义异常类。
public class CustomException extends RuntimeException {
public CustomException(String message) {
super(message);
}
}
在业务逻辑中，当遇到特定情况时，我们可以抛出这个自定义异常。
在控制器中使用自定义异常
@RestController
@RequestMapping("/api")
public class MyController {
@GetMapping("/test")
public ResponseEntity<String> testMethod() {
// 模拟业务逻辑异常
throw new CustomException("这是一个自定义异常");
}
}
当testMethod方法被调用时，它会抛出一个CustomException异常。由于我们已经定义了全局异常处理器，这个异常会被handleCustomException方法捕获并处理。
定义错误响应格式
为了保持错误响应的一致性，我们可以定义一个统一的错误响应格式。
public class ErrorResponse {
private String message;
public ErrorResponse(String message) {
this.message = message;
}
// getter和setter方法...
}
三、总结
通过使用@ControllerAdvice和@ExceptionHandler注解，我们可以在Spring Boot应用中实现统一异常处理。这种方式不仅减少了代码冗余，提高了代码的可读性和可维护性，还能为前端提供一致的错误响应格式，提升了用户体验。在实际开发中，我们还可以根据具体需求对异常处理进行更细粒度的控制，比如根据异常类型返回不同的HTTP状态码或错误消息。
欢迎关注我的公众号 “程序员洋哥” ，原创技术文章第一时间推送。
