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應用程序中的異常，并為用戶提供更好的錯誤體驗。