قراءة الويب هوك دون أن تفعل كلّ شيء مرّتين

كلّ نظام ويب هوك في العالم يسلّم مرّة واحدة على الأقلّ، والجميع يُفاجأ في المرّة الأولى. يصل الحدث مرّتين، ويُكتَب إلى العميل مرّتين، ويقول تقرير العطل إنّ الويب هوك معطوب. وهو ليس معطوباً: إنّه يفعل بالضبط ما وعد به.

لماذا التكرار أمر عادي

• كان معالجك بطيئاً، فكفّ المرسل عن الانتظار وحاول ثانيةً.
• ردّ معالجك بـ 500 بعد أن أنجز العمل.
• انقطع الاتصال بعد أن رددت وقبل أن يصل الردّ.
• أعاد نشرٌ تشغيل العملية في منتصف الطلب.

واحد من هذه فقط عطل في كودك، والأربعة جميعاً تنتج نسخة مكرّرة.

العلاج قيد تفرّد

CREATE TABLE handled (
  event_id TEXT PRIMARY KEY,
  handled_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

أدرج قبل أن تتصرّف. فإن تعارض الإدراج فقد عالجه أحدهم من قبل وانتهى شغلك. وهذا ينجو من إعادة التشغيل في المنتصف التي لا تنجو منها مجموعة في الذاكرة، ولا يحتاج إلى مكتبة ولا قفل ولا تنسيق بين العمّال.

أمران يخطئ فيهما الناس بعد ذلك

يردّون بـ 200 بعد العمل لا قبله، فيحوّلون معالجاً بطيئاً إلى معالج تُعاد محاولته. ويتحقّقون من التوقيع بعد قراءة الجسم، أي أنّهم حلّلوا أصلاً مُدخلاً ممّن عثر على العنوان أيّاً كان. التوقيع أوّلاً، ثم 200، ثم العمل.

أسئلة شائعة