Πώς χειρίζεσαι exceptions καθολικά με @ControllerAdvice;

Question

IT Interview Practice · Accepted Answer

Αντί να τυλίγεις κάθε controller method σε try/catch, το Spring σου επιτρέπει να συγκεντρώσεις τον χειρισμό σφαλμάτων σε μία class με annotation `@ControllerAdvice` (ή `@RestControllerAdvice`). Οι methods που φέρουν `@ExceptionHandler` πιάνουν exceptions που πετάγονται οπουδήποτε στους controllers σου και τα μετατρέπουν σε συνεπείς HTTP απαντήσεις.

## Ένας καθολικός 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);
    }
}
```

Κάθε controller μπορεί τώρα απλώς να κάνει `throw new EntityNotFoundException(...)` και να εμπιστευτεί το advice να διαμορφώσει την απάντηση.

## Η σύγχρονη επιλογή: ProblemDetail

Το Spring 6 / Boot 3 φέρνουν το RFC 9457 `ProblemDetail`, ένα τυποποιημένο σώμα σφάλματος:

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

## Γιατί έχει σημασία

Οι συνεπείς, αναγνώσιμες από μηχανή απαντήσεις σφάλματος είναι αυτό που ξεχωρίζει ένα επαγγελματικό API από ένα που διαρρέει stack traces. Οι συνεντευκτές θέλουν να δουν ότι συγκεντρώνεις τον χειρισμό (DRY), αντιστοιχίζεις exceptions στους *σωστούς* κωδικούς κατάστασης, και δεν εκθέτεις ποτέ εσωτερικές λεπτομέρειες στους clients. Η αναφορά στο `ProblemDetail` δείχνει ότι είσαι ενημερωμένος με το Boot 3.

Ένας καθολικός handler

Η σύγχρονη επιλογή: ProblemDetail

Γιατί έχει σημασία

Σχετικές ερωτήσεις