HTTP 400 Bad Request: المعنى والأسباب وطريقة الإصلاح

ماذا يعني

لا يستطيع الخادم معالجة الطلب لأنه مشوّه: صياغة غير صالحة، أو تأطير خاطئ، أو قيم يتعذر تحليلها.

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

JSON غير صالح أو Content-Type خاطئ
معاملات استعلام مفقودة أو مشوهة
ملفات تعريف ارتباط كبيرة جدًا أو تالفة

طريقة الإصلاح

إن كنت العميل أو الزائر

اقرأ التفاصيل في جسم الخطأ، وتحقق من الحمولة (يساعد منسق JSON)، وراجع Content-Type، وامسح ملفات تعريف الارتباط للموقع إذا أظهر المتصفح 400.

إن كنت مسؤولًا عن الموقع أو الواجهة البرمجية

أعد رسالة خطأ واضحة تسمّي الحقل الخاطئ، ويُفضل بصيغة application/problem+json. استخدم 422 للمدخلات سليمة الصيغة التي تفشل في التحقق.

مثال على الاستجابة

HTTP/1.1

HTTP/1.1 400 Bad Request
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Request body is not valid JSON: unexpected token at line 3."
}

المواصفة

RFC 9110 §15.5.1

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

› لماذا يصلح مسح ملفات تعريف الارتباط الخطأ 400؟

قد تجعل ملفات تعريف الارتباط الضخمة أو التالفة ترويسة الطلب غير صالحة أو كبيرة جدًا؛ وكثيرًا ما تجيب الخوادم على ذلك بـ 400.

› 400 أم 422؟

400 تعني أن الطلب تعذر تحليله. 422 تعني أنه حُلّل لكن القيم غير صالحة.