Come si gestiscono le eccezioni a livello globale con @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Invece di avvolgere ogni metodo del controller in try/catch, Spring ti permette di centralizzare la gestione degli errori in una classe annotata `@ControllerAdvice` (o `@RestControllerAdvice`). I metodi marcati `@ExceptionHandler` catturano le eccezioni sollevate ovunque nei tuoi controller e le trasformano in risposte HTTP coerenti.

## Un handler globale

```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);
    }
}
```

Qualsiasi controller ora può semplicemente fare `throw new EntityNotFoundException(...)` e fidarsi che l'advice modelli la risposta.

## L'opzione moderna: ProblemDetail

Spring 6 / Boot 3 includono `ProblemDetail` di RFC 9457, un corpo d'errore standardizzato:

```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
}
```

## Perché è importante

Risposte d'errore coerenti e leggibili dalla macchina sono ciò che distingue un'API professionale da una che fa trapelare stack trace. Gli intervistatori vogliono vedere che centralizzi la gestione (DRY), che mappi le eccezioni sui codici di stato *giusti* e che non esponi mai i dettagli interni ai client. Menzionare `ProblemDetail` dimostra che sei aggiornato con Boot 3.

Un handler globale

L'opzione moderna: ProblemDetail

Perché è importante

Domande correlate