Cum tratezi excepțiile global cu @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

În loc să înfășori fiecare metodă de controller în try/catch, Spring îți permite să centralizezi tratarea erorilor într-o singură clasă adnotată `@ControllerAdvice` (sau `@RestControllerAdvice`). Metodele marcate `@ExceptionHandler` prind excepțiile aruncate oriunde în controllerele tale și le transformă în răspunsuri HTTP consecvente.

## Un handler global

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

// Prinde această excepție din ORICE controller și returnează 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Eșecurile de validare (@Valid) aruncă asta — transformă erorile de câmp în 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);
    }
}
```

Orice controller poate acum doar să facă `throw new EntityNotFoundException(...)` și să aibă încredere că advice-ul va modela răspunsul.

## Opțiunea modernă: ProblemDetail

Spring 6 / Boot 3 livrează `ProblemDetail` conform RFC 9457, un corp de eroare standardizat:

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

## De ce contează

Răspunsurile de eroare consecvente și interpretabile de mașină sunt cele care separă un API profesional de unul care scurge stack trace-uri. Intervievatorii vor să vadă că centralizezi tratarea (DRY), că mapezi excepțiile la codurile de status *corecte* și că nu expui niciodată detalii interne clienților. Menționarea lui `ProblemDetail` arată că ești la zi cu Boot 3.

Un handler global

Opțiunea modernă: ProblemDetail

De ce contează

Întrebări conexe