Spring Boot : comment gérer proprement les exceptions dans une API REST ?

Question

Mes contrôleurs ont des `try/catch` partout qui renvoient des `ResponseEntity` différents. Comment centraliser ?

Accepted Answer

Utilise un `@RestControllerAdvice` avec des `@ExceptionHandler`, et le format standard **ProblemDetail** (RFC 9457) intégré à Spring 6 :

```java
@RestControllerAdvice
public class ApiExceptionHandler {

@ExceptionHandler(ResourceNotFoundException.class)
  ProblemDetail notFound(ResourceNotFoundException ex) {
    ProblemDetail pd = ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND, ex.getMessage());
    pd.setTitle("Ressource introuvable");
    return pd;
  }

@ExceptionHandler(MethodArgumentNotValidException.class)
  ProblemDetail invalid(MethodArgumentNotValidException ex) {
    ProblemDetail pd = ProblemDetail.forStatus(HttpStatus.BAD_REQUEST);
    pd.setProperty("errors", ex.getBindingResult().getFieldErrors().stream()
        .map(e -> Map.of("field", e.getField(), "message", e.getDefaultMessage())).toList());
    return pd;
  }
}
```

Active aussi `spring.mvc.problemdetails.enabled=true` pour que les erreurs internes de Spring suivent le même format. Tes contrôleurs se contentent alors de `throw new ResourceNotFoundException(...)`.

1 Answer