Bagaimana cara menangani exception secara global dengan @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Alih-alih membungkus setiap method controller dalam try/catch, Spring memungkinkan Anda memusatkan penanganan error dalam satu class yang dianotasi `@ControllerAdvice` (atau `@RestControllerAdvice`). Method yang ditandai `@ExceptionHandler` menangkap exception yang dilempar di mana pun dalam controller Anda dan mengubahnya menjadi response HTTP yang konsisten.

## Sebuah handler global

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

Controllern mana pun kini cukup `throw new EntityNotFoundException(...)` dan percaya bahwa advice akan membentuk response-nya.

## Opsi modern: ProblemDetail

Spring 6 / Boot 3 menyertakan RFC 9457 `ProblemDetail`, sebuah body error yang terstandarisasi:

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

## Mengapa ini penting

Response error yang konsisten dan dapat dibaca mesin adalah yang membedakan API profesional dari yang membocorkan stack trace. Interviewer ingin melihat Anda memusatkan penanganan (DRY), memetakan exception ke status code yang *tepat*, dan tidak pernah mengekspos detail internal ke client. Menyebut `ProblemDetail` menunjukkan Anda mengikuti perkembangan Boot 3.

Sebuah handler global

Opsi modern: ProblemDetail

Mengapa ini penting

Pertanyaan terkait