Hogyan kezelsz kivételeket globálisan `@ControllerAdvice`-szal?

Question

IT Interview Practice · Accepted Answer

Ahelyett, hogy minden controller metódust try/catch-be csomagolnál, a Spring lehetővé teszi, hogy a hibakezelést egyetlen `@ControllerAdvice`-szal (vagy `@RestControllerAdvice`-szal) annotált osztályban központosítsd. A `@ExceptionHandler`-rel jelölt metódusok elkapják a controllereidben bárhol dobott kivételeket, és konzisztens HTTP válaszokká alakítják őket.

## Egy globális 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);
    }
}
```

Bármelyik controller mostantól egyszerűen `throw new EntityNotFoundException(...)`-t dobhat, és megbízhat abban, hogy az advice formálja a választ.

## A modern opció: ProblemDetail

A Spring 6 / Boot 3 szállítja az RFC 9457 `ProblemDetail`-t, egy szabványosított hibatörzset:

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

## Miért fontos

A konzisztens, géppel olvasható hibaválaszok választják el a professzionális API-t attól, amelyik stack trace-eket szivárogtat. Az interjúztatók azt akarják látni, hogy központosítod a kezelést (DRY), a kivételeket a *helyes* státuszkódokra mappeled, és soha nem teszel elérhetővé belső részleteket a klienseknek. A `ProblemDetail` megemlítése azt mutatja, hogy naprakész vagy a Boot 3-mal.

Egy globális handler

A modern opció: ProblemDetail

Miért fontos

Kapcsolódó kérdések