Wie behandelst du Exceptions global mit @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Statt jede Controller-Methode in try/catch zu wickeln, lässt dich Spring die Fehlerbehandlung in einer Klasse zentralisieren, die mit `@ControllerAdvice` (oder `@RestControllerAdvice`) annotiert ist. Mit `@ExceptionHandler` markierte Methoden fangen Exceptions, die irgendwo in deinen Controllern geworfen werden, und verwandeln sie in konsistente HTTP-Antworten.

## Ein globaler Handler

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

Jeder Controller kann nun einfach `throw new EntityNotFoundException(...)` machen und darauf vertrauen, dass das Advice die Antwort formt.

## Die moderne Option: ProblemDetail

Spring 6 / Boot 3 liefern RFC 9457 `ProblemDetail`, einen standardisierten Fehler-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; // serialized as application/problem+json
}
```

## Warum es wichtig ist

Konsistente, maschinenlesbare Fehlerantworten sind das, was eine professionelle API von einer unterscheidet, die Stacktraces durchsickern lässt. Interviewer wollen sehen, dass du die Behandlung zentralisierst (DRY), Exceptions auf die *richtigen* Statuscodes mappst und niemals interne Details an Clients preisgibst. `ProblemDetail` zu erwähnen zeigt, dass du mit Boot 3 auf dem aktuellen Stand bist.

Ein globaler Handler

Die moderne Option: ProblemDetail

Warum es wichtig ist

Ähnliche Fragen