كيف تعمل معالجة الأخطاء في GraphQL؟

Question

IT Interview Practice · Accepted Answer

يعيد GraphQL دائمًا HTTP **200** لنقل ناجح؛ فالمشكلات تُبلَّغ في جسم الاستجابة، لا في رمز الحالة. تحتوي الاستجابة على مفتاحين على المستوى الأعلى: **`data`** و**`errors`**، ويمكن أن يوجدا معًا — وهذا هو **البيانات الجزئية** (partial data).

## البيانات الجزئية + مصفوفة errors

إذا رمى resolver حقل واحد استثناءً، يصبح ذلك الحقل `null`، ويُضاف عنصر إلى `errors`، لكن كل حقل آخر يظلّ يُحلّ. يحصل العميل على ما نجح مع وصف لما فشل.

```json
{
  "data": { "user": { "name": "Ada", "posts": null } },
  "errors": [
    {
      "message": "Failed to load posts",
      "path": ["user", "posts"],        // أي حقل بالضبط فشل
      "extensions": { "code": "DOWNSTREAM_TIMEOUT" }
    }
  ]
}
```

يحمل حقل **`extensions.code`** رمز خطأ قابلًا للقراءة آليًا لكي يتفرّع العملاء بناءً عليه. أما ما إذا كان الحقل الذي رمى استثناءً يجعل نفسه فقط null أم يصعد لأعلى فيعتمد على **القابلية للـ null**: حقل non-null (`posts: [Post!]!`) يخطئ يجعل أقرب أب قابل للـ null فوقه هو null بدلًا منه.

```js
import { GraphQLError } from "graphql";

const resolvers = {
  Mutation: {
    transfer: (_p, args, ctx) => {
      if (!ctx.user) {
        // أرفق رمزًا ثابتًا يتفرّع عليه العملاء؛ أخفِ التفاصيل الداخلية
        throw new GraphQLError("Not authenticated", {
          extensions: { code: "UNAUTHENTICATED" },
        });
      }
      // ...
    },
  },
};
```

تنمذج فرق كثيرة أيضًا الأخطاء **المتوقعة** (التحقق، "البريد مستخدَم") كجزء من الـ schema عبر union/result types، مع حصر مصفوفة `errors` للأخطاء **غير المتوقعة** — مما يُبقي تنميط المسار السعيد نظيفًا.

## لماذا يهم

يتحرّى المُحاورون ما إذا كنت تعرف أن الأخطاء تعيش في الجسم مع `data` جزئية، وأن الرموز تنتمي إلى `extensions`، وأن القابلية للـ null تتحكم في مدى صعود الخطأ. الخلط بين أخطاء GraphQL ورموز حالة HTTP علامة كلاسيكية على أن الشخص استخدم REST فقط.

البيانات الجزئية + مصفوفة errors

لماذا يهم

أسئلة ذات صلة