Bagaimana anda mengendalikan pengecualian secara global dengan @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Daripada membalut setiap kaedah controller dalam try/catch, Spring membolehkan anda memusatkan pengendalian ralat dalam satu kelas yang dianotasi `@ControllerAdvice` (atau `@RestControllerAdvice`). Kaedah yang ditanda `@ExceptionHandler` menangkap pengecualian yang dilontar di mana-mana dalam controller anda dan mengubahnya menjadi respons HTTP yang konsisten.

## Satu pengendali global

```java
@RestControllerAdvice // = @ControllerAdvice + @ResponseBody
public class GlobalExceptionHandler {

// Catches this exception from ANY controller and returns 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Validation failures (@Valid) throw this — turn field errors into 400.
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ApiError invalid(MethodArgumentNotValidException ex) {
        String msg = ex.getBindingResult().getFieldErrors().stream()
            .map(e -> e.getField() + " " + e.getDefaultMessage())
            .collect(Collectors.joining(", "));
        return new ApiError("VALIDATION", msg);
    }
}
```

Mana-mana controller kini boleh sekadar `throw new EntityNotFoundException(...)` dan mempercayai advice untuk membentuk respons.

## Pilihan moden: ProblemDetail

Spring 6 / Boot 3 menghantar RFC 9457 `ProblemDetail`, satu badan ralat yang diseragamkan:

```java
@ExceptionHandler(PaymentDeclinedException.class)
public ProblemDetail declined(PaymentDeclinedException ex) {
    var pd = ProblemDetail.forStatusAndDetail(HttpStatus.PAYMENT_REQUIRED, ex.getMessage());
    pd.setTitle("Payment declined");
    return pd; // serialized as application/problem+json
}
```

## Mengapa ia penting

Respons ralat yang konsisten dan boleh dibaca mesin ialah apa yang membezakan API profesional daripada yang membocorkan jejak tindanan. Penemu duga mahu melihat anda memusatkan pengendalian (DRY), memetakan pengecualian kepada kod status yang *betul*, dan tidak sekali-kali mendedahkan butiran dalaman kepada klien. Menyebut `ProblemDetail` menunjukkan anda terkini dengan Boot 3.

Satu pengendali global

Pilihan moden: ProblemDetail

Mengapa ia penting

Soalan berkaitan