Hoe handel je exceptions globaal af met @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

In plaats van elke controller-methode in try/catch te wikkelen, laat Spring je error-afhandeling centraliseren in één klasse geannoteerd met `@ControllerAdvice` (of `@RestControllerAdvice`). Methoden gemarkeerd met `@ExceptionHandler` vangen exceptions die overal in je controllers worden gegooid en zetten ze om in consistente HTTP-responses.

## Een globale handler

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

// Vangt deze exception uit ELKE controller en geeft 404 terug.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Validatiefouten (@Valid) gooien deze — zet field errors om in 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);
    }
}
```

Elke controller kan nu simpelweg `throw new EntityNotFoundException(...)` en erop vertrouwen dat de advice de response vormgeeft.

## De moderne optie: ProblemDetail

Spring 6 / Boot 3 leveren RFC 9457 `ProblemDetail`, een gestandaardiseerde error-body:

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

## Waarom het belangrijk is

Consistente, machine-leesbare error-responses onderscheiden een professionele API van een die stack traces lekt. Interviewers willen zien dat je afhandeling centraliseert (DRY), exceptions op de *juiste* statuscodes mapt, en nooit interne details aan clients blootstelt. `ProblemDetail` noemen laat zien dat je bij bent met Boot 3.

Een globale handler

De moderne optie: ProblemDetail

Waarom het belangrijk is

Gerelateerde vragen