Kaip globaliai tvarkyti išimtis su @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Užuot apvyniojus kiekvieną kontrolerio metodą try/catch, Spring leidžia centralizuoti klaidų tvarkymą vienoje klasėje, pažymėtoje `@ControllerAdvice` (arba `@RestControllerAdvice`). Metodai, pažymėti `@ExceptionHandler`, gaudo išimtis, mestas bet kur jūsų kontroleriuose, ir paverčia jas nuosekliais HTTP atsakymais.

## Globalus handleris

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

// Gaudo šią išimtį iš BET KOKIO kontrolerio ir grąžina 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Validacijos nesėkmės (@Valid) meta šią — laukų klaidas paverčiame į 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);
    }
}
```

Dabar bet kuris kontroleris gali tiesiog `throw new EntityNotFoundException(...)` ir pasitikėti, kad advice suformuos atsakymą.

## Modernus variantas: ProblemDetail

Spring 6 / Boot 3 pateikia RFC 9457 `ProblemDetail`, standartizuotą klaidos turinį:

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

## Kodėl tai svarbu

Nuoseklūs, mašininiu būdu skaitomi klaidos atsakymai skiria profesionalų API nuo tokio, kuris nutekina stack trace. Interviuotojai nori matyti, kad centralizuojate tvarkymą (DRY), susiejate išimtis su *teisingais* statuso kodais ir niekada neatskleidžiate vidinių detalių klientams. `ProblemDetail` paminėjimas rodo, kad esate susipažinę su Boot 3.

Globalus handleris

Modernus variantas: ProblemDetail

Kodėl tai svarbu

Susiję klausimai