WebGroundwebground.app
معلومات وأدلة · مرجع ويب

مرجع رموز حالة HTTP وتصحيح الأخطاء

دليل قابل للبحث لرموز استجابة HTTP من 1xx إلى 5xx مع معانيها ونصائح عملية لتشخيص واجهات البرمجة وCDN.

عرض ٢٦ رمزًا
100

Continue

استلم الخادم الترويسات الأولية؛ يمكن للعميل متابعة إرسال جسم الطلب.

نصيحة: شائع عند إرسال حمولات كبيرة مع ترويسة Expect: 100-continue.

101

Switching Protocols

وافق الخادم على ترقية بروتوكول الاتصال، غالباً من HTTP إلى WebSocket.

نصيحة: افحص ترويستي Upgrade وConnection إذا تعثّر مصافح WebSocket.

200

OK

استجابة قياسية تؤكد نجاح طلب HTTP.

نصيحة: تحقّق من Content-Type وبنية JSON إذا فشل العميل في العرض رغم النجاح.

201

Created

نجح الطلب وأنشأ مورداً جديداً أو أكثر.

نصيحة: تُرفق واجهات REST عادة ترويسة Location تشير إلى رابط المورد الجديد.

204

No Content

نجح الطلب وأرجع الخادم جسماً فارغاً عمداً.

نصيحة: تجنّب استدعاء response.json() على استجابة 204 (شائع في DELETE أو OPTIONS).

206

Partial Content

أرسل الخادم نطاق البايتات المطلوب فقط من الملف.

نصيحة: يُستخدم في بث الفيديو واستكمال التنزيل عبر ترويسات Range.

301

Moved Permanently

نُقل المورد نهائياً إلى رابط جديد؛ وتنقل محركات البحث قيمة SEO.

نصيحة: تخزن المتصفحات 301 بقوة في الذاكرة المؤقتة — اختبر بالتصفح الخفي أو curl -I.

302

Found (إعادة توجيه مؤقتة)

يُخدم المورد مؤقتاً من رابط آخر مع بقاء الرابط الأصلي مفهرساً.

نصيحة: يُستخدم كثيراً في مسارات تسجيل الدخول OAuth أو الصيانة المؤقتة.

304

Not Modified

النسخة المخزنة مؤقتاً لا تزال صالحة وفق ETag أو Last-Modified.

نصيحة: يوفر النطاق الترددي للملفات الثابتة؛ راجع Cache-Control إذا استمرت ملفات قديمة.

307

Temporary Redirect

إعادة توجيه مؤقتة تحافظ بصرامة على أسلوب HTTP والجسم الأصلي.

نصيحة: استخدم 307 بدلاً من 302 عندما يجب أن يبقى طلب POST كما هو بعد التوجيه.

308

Permanent Redirect

إعادة توجيه دائمة تحافظ بصرامة على أسلوب HTTP والجسم الأصلي.

نصيحة: شائع في توجيهات الشرطة المائلة الأخيرة في Next.js وتوحيد HTTPS.

400

Bad Request

تعذر على الخادم معالجة الطلب لوجود صياغة معطوبة أو معاملات غير صالحة.

نصيحة: تحقق من صحة JSON والحقول المطلوبة وترويسة Content-Type.

401

Unauthorized

المصادقة مفقودة أو منتهية الصلاحية أو غير صالحة للنقطة المطلوبة.

نصيحة: افحص صلاحية رمز Bearer أو مفتاح API أو ملفات تعريف ارتباط الجلسة.

403

Forbidden

هوية العميل معروفة (أو محجوبة بسياسة)، لكنه لا يملك إذن الوصول.

نصيحة: راجع أدوار RBAC وقواعد CORS/WAF أو أذونات الملفات والحاويات.

404

Not Found

تعذر على الخادم العثور على المسار أو المورد المطلوب.

نصيحة: تحقق من الشرطة المائلة النهائية والمسار الأساسي وتوجيه DNS أو المعرفات المحذوفة.

405

Method Not Allowed

النقطة موجودة، لكنها لا تدعم فعل HTTP المستخدم (مثل GET بدل POST).

نصيحة: افحص ترويسة Allow لمعرفة أساليب HTTP المقبولة.

408

Request Timeout

استغرق العميل وقتاً طويلاً لإتمام إرسال الطلب قبل إغلاق الاتصال.

نصيحة: راجع عمليات الرفع البطيئة على شبكة الجوال أو مهلة keep-alive.

409

Conflict

يتعارض الطلب مع الحالة الحالية للمورد المستهدف.

نصيحة: شائع عند تكرار تسجيل بريد إلكتروني أو عدم تطابق ETag.

413

Content Too Large

حجم حمولة الطلب يتجاوز الحد المسموح على الخادم أو البروكسي العكسي.

نصيحة: اضغط الصور محلياً قبل الرفع أو ارفع حد حجم الطلب في البروكسي.

415

Unsupported Media Type

يرفض الخادم صيغة الحمولة المحددة في ترويسة Content-Type.

نصيحة: تأكد من تطابق Content-Type: application/json أو multipart/form-data مع الجسم.

422

Unprocessable Content

الصياغة سليمة (مثل JSON صحيح)، لكن القيم فشلت في التحقق الدلالي.

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

429

Too Many Requests

تجاوز العميل حد المعدل (Rate Limit) المسموح في واجهة البرمجة.

نصيحة: التزم بترويسة Retry-After وأضف تأخيراً أسياً مع عشوائية عند إعادة المحاولة.

500

Internal Server Error

حدث استثناء غير معالَج غير متوقع على الخادم الأصلي.

نصيحة: افحص سجلات الأخطاء ومتغيرات البيئة الناقصة أو تعطل قاعدة البيانات.

502

Bad Gateway

تلقى البروكسي أو CDN استجابة غير صالحة من الخادم المنبع.

نصيحة: تأكد من تشغيل تطبيق المنبع واستماعه على المنفذ الصحيح.

503

Service Unavailable

الخادم مثقل مؤقتاً أو متوقف لأعمال صيانة مجدولة.

نصيحة: راجع ترويسات Retry-After أو إخفاق فحوصات الصحة أو نفاد البدء البارد.

504

Gateway Timeout

انتهت مهلة البروكسي أو CDN أثناء انتظار رد الخادم المنبع.

نصيحة: حسّن استعلامات قاعدة البيانات البطيئة أو انقل المهام الطويلة لقوائم انتظار غير متزامنة.

هل تصحح الآن خطأ 400 Bad Request أو استجابة JSON من واجهة برمجية؟فتح منسّق JSON

فهم الفئات الخمس لرموز حالة HTTP

تبدأ كل استجابة HTTP برمز من ثلاثة أرقام معرّف في معيار RFC 9110. تصنيف الرموز حسب الرقم الأول يمكّن المطورين ومهندسي DevOps ومتخصصي SEO من تشخيص الأعطال خلال ثوانٍ.

عموماً: تشير 1xx إلى تبادل البروتوكول، و2xx إلى النجاح، و3xx إلى التخزين المؤقت أو إعادة التوجيه، و4xx إلى خطأ في طلب العميل، و5xx إلى فشل الخادم الأصلي أو الخادم الوسيط.

أخطاء شائعة في التمييز بين الرموز أثناء التشغيل

معرفة الفروق الدقيقة بين الرموز المتجاورة يمنع أخطاء يصعب تتبعها:

  • 401 Unauthorized مقابل 403 Forbidden: يعني 401 غياب بيانات المصادقة أو انتهاء صلاحيتها، بينما يعني 403 أن العميل معروف لكنه لا يملك الصلاحية.
  • 301/302 مقابل 307/308: قد تحوّل تحويلات 301/302 القديمة طلب POST إلى GET، في حين تحافظ 307 و308 على أسلوب الطلب وجسمه الأصلي.
  • 502 Bad Gateway مقابل 504 Gateway Timeout: يدل 502 على استجابة غير صالحة من الخادم المنبع، بينما يعني 504 انتهاء مهلة انتظاره.

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

ما الفرق بين 401 و403؟+

يشير 401 إلى نقص أو بطلان بيانات المصادقة، أما 403 فيعني أن الخادم فهم الهوية أو طبّق سياسة حظر ورفض الإذن.

كيف ينبغي للعملاء التعامل مع 429 Too Many Requests؟+

تحقّق من ترويسة Retry-After عند وجودها وأعد المحاولة باستخدام تأخير أسي (Exponential Backoff) مع عشوائية (Jitter).

لماذا يكسر 204 No Content الدالة response.json() في JavaScript؟+

لأن استجابة 204 تأتي بجسم فارغ عمداً؛ استدعاء response.json() يطلق خطأ تحليل JSON. تحقّق من response.status === 204 أولاً.

استكشف المزيد على WebGround

عرض الكل