خطأ HTTP 422 Unprocessable Content

كود الحالة 422 · الفئة 4xx

HTTP

الرسالة الرسمية (كما تظهر على الشاشة): Unprocessable Content

يُبحث عنه أيضًا باسم: error 422, HTTP 422, 422 unprocessable entity, 422 unprocessable content

سلسلة طلب HTTP من المتصفح عبر CDN والوكيل إلى الخادم الأصلي
أخطاء HTTP: حدد أي حلقة في سلسلة الطلب فشلت واقرأ سجلاتها.

ماذا يعني

فهم الخادم صيغة الطلب لكن البيانات داخله غير صالحة، فتعذّرت معالجته. تُرجع واجهات API والأطر مثل Rails وLaravel وFastAPI الرمز 422 عند أخطاء التحقق من الصحة، كحقل مطلوب مفقود أو نوع بيانات خاطئ.

ينطبق على: REST APIs, Rails, Laravel, FastAPI

كيفية إصلاح خطأ HTTP 422 Unprocessable Content

  1. اقرأ نص الاستجابة؛ فهو يسرد عادةً الحقول التي فشل التحقق منها
  2. قارن الحقول المطلوبة والصيغ (البريد الإلكتروني والتواريخ) ونطاقات القيم مع توثيق API
  3. تأكد من أن ترويسة Content-Type تطابق المحتوى (مثلاً 'application/json' مع JSON صالح)
  4. افحص عدم تطابق الأنواع، مثل إرسال نص حيث يُتوقع رقم
  5. في نماذج Rails وLaravel، قد يظهر انتهاء صلاحية رمز CSRF أيضاً على شكل استجابة 422 أو 419؛ أعد تحميل النموذج
  6. إذا كنت مالك الواجهة (API): أرجع رسائل خطأ منظمة على مستوى الحقول ليتمكن العملاء من تصحيح المدخلات

سبب حدوثه

معرَّف في RFC 9110 (وكان يسمى 'Unprocessable Entity' في WebDAV)، ويشير 422 إلى محتوى سليم الصياغة لكنه غير صالح دلالياً. وهو استجابة فشل التحقق القياسية في أطر كثيرة.

الأسئلة الشائعة

ما الفرق بين 400 و422؟

الرمز 400 يعني أن الطلب نفسه مشوّه. أما 422 فيعني أن الصياغة سليمة لكن المحتوى لا يجتاز التحقق.

أخطاء ذات صلة

المصدر: IANA HTTP Status Code Registry · حلول كتبها المحررون وراجعوها (راجع السياسة التحريرية)

آخر تحديث: