Comment gérer les exceptions de manière globale avec @ControllerAdvice ?

Question

IT Interview Practice · Accepted Answer

Plutôt que d'envelopper chaque méthode de contrôleur dans un try/catch, Spring vous permet de centraliser la gestion des erreurs dans une seule classe annotée `@ControllerAdvice` (ou `@RestControllerAdvice`). Les méthodes marquées `@ExceptionHandler` interceptent les exceptions levées n'importe où dans vos contrôleurs et les transforment en réponses HTTP cohérentes.

## Un gestionnaire global

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

// Intercepte cette exception de N'IMPORTE QUEL contrôleur et renvoie 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Les échecs de validation (@Valid) lèvent ceci — transforme les erreurs de champ en 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);
    }
}
```

N'importe quel contrôleur peut désormais simplement faire `throw new EntityNotFoundException(...)` et se fier à l'advice pour façonner la réponse.

## L'option moderne : ProblemDetail

Spring 6 / Boot 3 embarquent le `ProblemDetail` de la RFC 9457, un corps d'erreur normalisé :

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

## Pourquoi c'est important

Des réponses d'erreur cohérentes et exploitables par la machine sont ce qui sépare une API professionnelle d'une API qui laisse fuiter des stack traces. Les recruteurs veulent vous voir centraliser la gestion (DRY), associer les exceptions aux *bons* codes de statut, et ne jamais exposer de détails internes aux clients. Mentionner `ProblemDetail` montre que vous êtes à jour avec Boot 3.

Un gestionnaire global

L'option moderne : ProblemDetail

Pourquoi c'est important

Questions connexes