Spring Boot处理异常最佳实践

Spring Boot在处理异常方面提供了许多内置功能，使得开发者能够更轻松地处理异常。以下是一些处理异常的最佳实践：

1. 使用@ControllerAdvice注解：通过使用@ControllerAdvice注解，您可以创建一个全局的异常处理类，该类将处理整个应用程序中的所有控制器抛出的异常。这使得异常处理更加集中和一致。

@ControllerAdvice
public class GlobalExceptionHandler {
    // ...
}

2. 使用@ExceptionHandler注解：在全局异常处理类中，您可以使用@ExceptionHandler注解来处理特定类型的异常。这使得您可以为不同类型的异常提供不同的处理逻辑。

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = {NotFoundException.class})
    public ResponseEntity<ErrorResponse> handleNotFoundException(NotFoundException ex) {
        ErrorResponse errorResponse = new ErrorResponse(HttpStatus.NOT_FOUND.value(), ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.NOT_FOUND);
    }
}

3. 使用@ResponseStatus注解：通过在自定义异常类上使用@ResponseStatus注解，您可以为特定异常设置HTTP状态码。这使得您可以轻松地为异常提供适当的状态码。

@ResponseStatus(HttpStatus.NOT_FOUND)
public class NotFoundException extends RuntimeException {
    // ...
}

4. 使用ErrorController接口：实现ErrorController接口允许您自定义错误页面。这对于为不同类型的错误提供不同的用户友好页面非常有用。

@Controller
public class CustomErrorController implements ErrorController {

    @RequestMapping("/error")
    public String handleError(HttpServletRequest request) {
        Object status = request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);

        if (status != null) {
            int statusCode = Integer.parseInt(status.toString());

            if (statusCode == HttpStatus.NOT_FOUND.value()) {
                return "404";
            } else if (statusCode == HttpStatus.INTERNAL_SERVER_ERROR.value()) {
                return "500";
            }
        }
        return "error";
    }

    @Override
    public String getErrorPath() {
        return "/error";
    }
}

5. 使用@Valid注解：在控制器方法中，您可以使用@Valid注解来触发请求对象的验证。如果验证失败，将生成一个MethodArgumentNotValidException异常，您可以捕获并处理该异常以返回自定义的错误响应。

@PostMapping("/users")
public ResponseEntity<?> createUser(@Valid @RequestBody User user) {
    // ...
}

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = {MethodArgumentNotValidException.class})
    public ResponseEntity<ErrorResponse> handleMethodArgumentNotValid(MethodArgumentNotValidException ex) {
        ErrorResponse errorResponse = new ErrorResponse(HttpStatus.BAD_REQUEST.value(), ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
    }
}

6. 使用@RestControllerAdvice注解：如果您使用的是Spring Boot 2.x或更高版本，可以使用@RestControllerAdvice注解替换@ControllerAdvice注解。这将确保您的全局异常处理类仅处理控制器返回的响应体中的异常。

@RestControllerAdvice
public class GlobalExceptionHandler {
    // ...
}

遵循这些最佳实践，您将能够更轻松地处理Spring Boot应用程序中的异常，并为用户提供更好的错误体验。