Kako globalno obraditi iznimke s @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Umjesto omatanja svake metode kontrolera u try/catch, Spring vam omogućuje centraliziranje obrade pogrešaka u jednoj klasi anotiranoj `@ControllerAdvice` (ili `@RestControllerAdvice`). Metode označene `@ExceptionHandler` hvataju iznimke bačene bilo gdje u vašim kontrolerima i pretvaraju ih u dosljedne HTTP odgovore.

## Globalni handler

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

// Hvata ovu iznimku iz BILO KOJEG kontrolera i vraća 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Neuspjesi validacije (@Valid) bacaju ovo — pretvori pogreške polja u 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);
    }
}
```

Bilo koji kontroler sada može jednostavno `throw new EntityNotFoundException(...)` i pouzdati se da će advice oblikovati odgovor.

## Moderna opcija: ProblemDetail

Spring 6 / Boot 3 isporučuju RFC 9457 `ProblemDetail`, standardizirano tijelo pogreške:

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

## Zašto je to važno

Dosljedni, strojno čitljivi odgovori na pogreške ono su što razdvaja profesionalni API od onoga koji curi stack traceove. Ispitivači žele vidjeti da centralizirate obradu (DRY), mapirate iznimke na *ispravne* statusne kodove i nikad ne izlažete interne detalje klijentima. Spominjanje `ProblemDetail` pokazuje da ste u toku s Bootom 3.

Globalni handler

Moderna opcija: ProblemDetail

Zašto je to važno

Povezana pitanja