คุณจัดการ exception แบบรวมศูนย์ด้วย @ControllerAdvice อย่างไร?

Question

IT Interview Practice · Accepted Answer

แทนที่จะห่อทุก method ของ controller ด้วย try/catch Spring ให้คุณรวมศูนย์การจัดการ error ไว้ในคลาสเดียวที่ประกาศ `@ControllerAdvice` (หรือ `@RestControllerAdvice`) method ที่ทำเครื่องหมาย `@ExceptionHandler` จะดักจับ exception ที่ถูกโยนออกมาจากที่ใดก็ตามใน controller ของคุณ แล้วเปลี่ยนให้เป็น HTTP response ที่สม่ำเสมอ

## global 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 เป็นผู้จัดรูป response

## ทางเลือกสมัยใหม่: ProblemDetail

Spring 6 / Boot 3 มาพร้อม `ProblemDetail` ตาม RFC 9457 ซึ่งเป็น error body มาตรฐาน:

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

## ทำไมจึงสำคัญ

error response ที่สม่ำเสมอและเครื่องอ่านได้ คือสิ่งที่แยก API ระดับมืออาชีพออกจาก API ที่ปล่อย stack trace รั่วไหล ผู้สัมภาษณ์อยากเห็นว่าคุณรวมศูนย์การจัดการ (DRY), map exception ไปยัง status code ที่ *ถูกต้อง* และไม่เปิดเผยรายละเอียดภายในให้ client เด็ดขาด การกล่าวถึง `ProblemDetail` แสดงว่าคุณทันสมัยกับ Boot 3

global handler

ทางเลือกสมัยใหม่: ProblemDetail

ทำไมจึงสำคัญ

คำถามที่เกี่ยวข้อง