乱抛异常？我们统一处理！！！

各位粉丝朋友大家好呀，这个周末好累，一边遛娃，一边准备下周的知识分享，感谢杭州的雨给了我一整上午的时间来梳理总结。

在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状态码或错误消息。