كيف تعالج الاستثناءات عالميًا باستخدام @ControllerAdvice؟

Question

IT Interview Practice · Accepted Answer

بدل لفّ كل دالة متحكم بـ try/catch، يتيح لك Spring تمركز معالجة الأخطاء في فئة واحدة مُعلَّمة بـ `@ControllerAdvice` (أو `@RestControllerAdvice`). الدوال المُعلَّمة بـ `@ExceptionHandler` تلتقط الاستثناءات المرمية في أي مكان في متحكماتك وتحوّلها إلى استجابات HTTP متسقة.

## معالج عالمي

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

// يلتقط هذا الاستثناء من أي متحكم ويعيد 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// إخفاقات التحقق (@Valid) ترمي هذا — حوّل أخطاء الحقول إلى 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);
    }
}
```

يستطيع أي متحكم الآن ببساطة `throw new EntityNotFoundException(...)` والوثوق بأن الـ advice سيُشكّل الاستجابة.

## الخيار الحديث: ProblemDetail

يشحن Spring 6 / Boot 3 معيار `ProblemDetail` بحسب RFC 9457، وهو جسم خطأ مُوحَّد:

```java
@ExceptionHandler(PaymentDeclinedException.class)
public ProblemDetail declined(PaymentDeclinedException ex) {
    var pd = ProblemDetail.forStatusAndDetail(HttpStatus.PAYMENT_REQUIRED, ex.getMessage());
    pd.setTitle("Payment declined");
    return pd; // يُسلسَل كـ application/problem+json
}
```

## لماذا يهم

الاستجابات الخطأية المتسقة والقابلة للقراءة آليًا هي ما يفصل API احترافيًا عن آخر يسرّب آثار الاستدعاء. يريد المُحاورون رؤيتك تُمركز المعالجة (DRY)، وتربط الاستثناءات بـ *رموز* الحالة الصحيحة، ولا تكشف أبدًا التفاصيل الداخلية للعملاء. ذكر `ProblemDetail` يُظهر أنك مواكب لـ Boot 3.

معالج عالمي

الخيار الحديث: ProblemDetail

لماذا يهم

أسئلة ذات صلة