خطأ HTTP 409 Conflict

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

HTTP

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

يُبحث عنه أيضًا باسم: error 409, HTTP 409, 409 conflict

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

ماذا يعني

تعذّر إكمال الطلب لأنه يتعارض مع الحالة الحالية للمورد. تُرجع واجهات API الرمز 409 عندما تحاول إنشاء شيء موجود مسبقاً، أو تحديث سجل غيّره شخص آخر، أو تنفيذ إجراء غير مسموح في الحالة الحالية.

ينطبق على: REST APIs, WebDAV, واجهات API لاستضافة Git

كيفية إصلاح خطأ HTTP 409 Conflict

  1. حدّث البيانات وأعد المحاولة اعتماداً على أحدث نسخة
  2. اقرأ نص الاستجابة؛ فواجهات API الجيدة التصميم توضح الحقل أو النسخة المتعارضة
  3. عند إنشاء مورد، تحقق مما إذا كان موجوداً بالفعل (اسم مستخدم أو بريد إلكتروني أو معرّف مكرر)
  4. إذا كانت الواجهة تستخدم ETags، فأرسل القيمة الحالية في 'If-Match' وأعد المحاولة بعد جلب أحدث نسخة
  5. في عملاء مزامنة الملفات أو WebDAV، عالج النسخة المتعارضة يدوياً
  6. إذا كنت مالك الواجهة (API): أرجع رسالة خطأ واضحة ونسخة المورد الحالية ليتمكن العملاء من التعافي

سبب حدوثه

يستخدم RFC 9110 الرمز 409 للتعارض مع الحالة الحالية للمورد المستهدف، وعادةً بسبب تعديلات متزامنة أو قيود تفرّد أو انتقالات حالة غير صالحة.

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

هل 409 خطأ من الخادم؟

لا. إنه رمز 4xx من جهة العميل: الطلب صالح لكنه يتصادم مع بيانات موجودة ويحتاج إلى تعديل أو إعادة محاولة.

أخطاء ذات صلة

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

آخر تحديث: