استراتيجيات التكرار والحماقة

1) لماذا تحتاجه

1. تكرار الأمان (الخصوصية)،

2. لوحظت حالات تأخير بين التكرار،

3. وتحترم «الصحة» الحدود/الحصص والإدمان.

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

2) تصنيف دلالات التسليم

على الأكثر مرة واحدة: لا تكرار، خطر الخسارة (قطع الأشجار، النار والنسيان).
مرة واحدة على الأقل: من الممكن تكرار ذلك → هناك حاجة إلى إفراط المستهلك (معظم قوائم الانتظار وخطافات الويب).
مرة واحدة بشكل فعال: النسخ المكررة ممكنة، لكنها مفككة بشكل صحيح (المفاتيح والمعاملات وصندوق الخروج).

3) متى تتراجع ومتى لا

التراجع منطقي: «408»، «429» (مراقبة «Retry-After»)، «425» (مبكرًا جدًا)، «499» (العميل مغلق على المحيط)، «5xx»، «504»، الشبكة المهلة/الفواصل، «502» عند البوابة، «إعادة ضبط الاتصال».
لا تتراجع دون تغيير الاستفسار: «400/ 401/403/404/422».
القضايا المثيرة للجدل: "409 Conflict' (ليس عادة retrayim; أولا نقرأ حالة العملية/نعيد تأكيد النية).

4) المهلة، التراجع والركض

4. 1 القواعد

المهلة الأولى، ثم الرجعية: يجب أن يكون لكل طلب «موعد نهائي».
التراجع الأسي: «التأخير _ n = الأساس 2 ^ n»، الحد «max _ delay».
الجتر مطلوب: أضف العشوائية لفصل «الموجات المتزامنة الباهتة».

4. 2 أنماط الجتر

النفاخ الكامل: «النوم = الراند (0، base2 ^ n)» هو أفضل خيار عام.
رعشة مزخرفة: «نوم = دقيقة (max_delay، راند (قاعدة، sleep_prev3))» - للحوارات الطويلة.
رعشة متساوية: «النوم = base2 ^ n/2 + rand (0، base2 ^ n/2)» - تباين ناعم.

4. 3 إعادة الميزانية

• 'retry _ budget _ per _ min = max (α success_rps، الطابق β)' ؛ عادة 'α = 0. 1–0. 2`.
• إذا كانت الميزانية مستنفدة، فتحول إلى قاطع فاشل سريع/دائرة «مفتوح».

5) التفاعل مع تحديد المعدل وقاطع الدائرة

احترم "Retry-After" و "RateLimite-Reset' واحسبها في التراجع.
عند «5xx »/المهلة العالية - اخفض تردد إعادة الدفع والتزامن العام.

• نصف مفتوح: يسمح بأخذ عينات محدودة.
• مفتوح: يرفض على الفور (يحفظ الموارد).
• مغلق: عمل عادي.
• في عمليات الكتابة، من الأفضل إعادة 409/503 مع تلميح واضح على إعادة التواء عدوانية.

6) فراغ عمليات الكتابة

6. 1 فكرة عامة

نفس النوايا → نتيجة واحدة. الأساس هو مفتاح الاختصاص وتخزين سجلات التنفيذ.

6. 2 عقد HTTP

Idempotency-Key: 7a6b7f9e-2a46-4d0b-9c3a-2b30e1c3c9e3
Idempotency-Key-Expiry: 24h # optional

• يحفظ (المفتاح، النتيجة → الحالة، تجزئة الجسم) على النجاح الأول
• إذا تكرر، يعيد الرد القديم والرأس «Idempotency-Replay: صحيح» ؛
• في حالة تضارب الجسم (نفس المفتاح، ولكن حمولة مختلفة) - «409 صراع».

6. 3 التخزين و TTL

الجدول/مفتاح القيمة: «الخصوصية _ المفتاح»، «الطلب _ التجزئة»، «النتيجة»، «الحالة»، «الصلاحية _ في».
TTL = نافذة الإعادة المحتملة والتسليم المتأخر (عادة 24-72 ساعة للمدفوعات).
المؤشرات حسب «الخصوصية _ المفتاح» ؛ للحمل العالي - التجزئة.

6. 4 مثال مخطط (SQL)

sql
CREATE TABLE idempo_store (
key UUID PRIMARY KEY,
req_hash BYTEA NOT NULL,
status INT NOT NULL,
response JSONB NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
expiry_at TIMESTAMPTZ NOT NULL
);

6. 5 المعالج الزائف

pseudo handle_write(req):
k = req. headers["Idempotency-Key"]
h = hash(req. body)
rec = idempo_store. get(k)

if rec and rec. req_hash == h:
return rec. status, rec. response, {"Idempotency-Replay": "true"}

if rec and rec. req_hash!= h:
return 409, problem("IDEMPOTENT_CONFLICT")

begin tx result = apply_business_mutation (req) # change status upsert once (idempo_store, key = k, req_hash=h, status = 201, response = result, expiry = now () + 2d)
commit

return 201, result

7) أنماط «فعالة مرة واحدة»

صندوق المعاملات الخارجي: تسجيل حدث تجاري وإرسال رسالة من نفس معاملة قاعدة البيانات من خلال ترحيل المعلومات الأساسية ؛ فالمستهلك متهور.
Inbox/الطاولة المعالجة لدى المستهلك: احفظ «event _ id» لتجاهل النسخ المكررة.
مرة واحدة بالضبط على Kafka ≠ مرة واحدة بالضبط في العمل: حتى مع EOS للمنتج/المستهلك، يجب أن يظل المنطق المطبق غبيًا.
المعاملات التعويضية (Saga): إذا تراجعت الخطوات وتسببت في آثار جانبية، فإننا نعيد النظام إلى الثابت.

8) الحالات الخاصة: المدفوعات والمعاملات المالية

الخصوصية القوية: يرتبط المفتاح بمنطق التشغيل (على سبيل المثال 'external _ payment _ id').
التفريغ على PSP - Store «merchant _ reference» → إذا تكرر، فإن PSP سيعيد نفس النتيجة.
إعادة الطباعة «من العميل»: السماح فقط عند «مفتاح الخصوصية»، وإلا فإن خطر الشطب المزدوج.
المنافسة: أقفال «على الحساب/الأداة/العقد» طوال مدة التنفيذ ؛ عندما تتكرر، ترجع 409/423.
إمكانية الرصد: المقاييس 'idempo _ repay _ total'، 'idempo _ conflict _ total'.

9) شبكات الويب والتحديات الخارجية

توقيعات HMAC ونافذة زمنية ؛ أولا التحقق، ثم المعالجة.
يعيد المرسل: التراجع الأسي + النرجس، «max _ traits» و DLQ.
المستهلك - الخصوصية: 'event _ id' → table/in-memory cache; النظام «المرتب» غير مضمون.
الرموز: 2xx = ناجح، 4xx = لا تتكرر، 5xx/timeout = تكرار.

10) طوابير الانتظار والمهام الأساسية

مرة واحدة على الأقل افتراضيًا → النسخ المكررة أمر لا مفر منه.
تخزين 'task _ id '/' event _ id' وحالة التنفيذ ؛ مع نسخ مكررة - المسار القصير «إعادة التشغيل».
DLQ والرسائل السامة: محاولة العداد، الحجر الصحي، التحليل اليدوي.
الحدود التنافسية (السيمافورات) والعمال الحمقى.

11) النسخ والمفاتيح «الطبيعية»

المفاتيح الطبيعية (رقم الحساب + تاريخ + رقم المستند) تزيد من مقاومة التكرار.
عند تغيير المخطط/الإصدار، قم بتضمين مفتاح الإصدار في «Idempotency-Key» أو في هاش الاستعلام.

12) رؤوس HTTP والمطالبات للعميل

«Idempotency-Key»، «Idempotency-Replay»، «Retry-After»، «أفضل: انتظر = <sec>» (في العمليات الطويلة)، «If-Match »/« ETag» (أقفال متفائلة).
409 لصراع رئيسي 425/429/503 مع «Retry-After» الصحيح.
للعمليات «الطويلة» - استقبال الحالة غير المتزامنة («202 مقبولة» + «الموقع» لكل مورد حالة).

13) سيناريوهات الاختبار والفوضى

الاختبارات السلبية: إرسال مزدوج، تكرار مع جسم آخر، عدم تزامن الساعة.
خارج النظام: «t2» يأتي قبل «t1».
حقن المهلات/' RST '/' EOF '، نصف الطلبات (البطيئة).
التخزين الخفي المتساقط → السلوك المغلق (فشل أفضل من الشطب المزدوج).

14) المقاييس والتنبيهات

"retries _ total {reason}", "retry _ budget _ used {routh}", "backoff _ seconds _ bucket'.
«idempo _ repay _ total», «idempo _ conflict _ total», «duplicate _ detected _ total».
شارك 409/425/429/5xx بالطرق ؛ p95/p99 «حان وقت النجاح» مع التراجعات.
التنبيهات: ميزانية إعادة الدفع بمعدل الحرق، وزيادة في صراعات الغباء، ونمو DLQ.

15) أنتيباترن

تراجع عن كل الأخطاء على التوالي.
عدم وجود النبضات → موجات متزامنة من الارتجاعات.
مفاتيح طويلة العمر بدون TTL والتنظيف.
حفظ النتيجة بعد ارتكاب أحد الآثار الجانبية (انتهاك صندوق الخروج).
ومن المستحيل → توليد جذوع الأشجار التي لا تحتوي على «أثر - معرف »/« مفتاح الخصوصية».
عدوانية موازية يعيد عمليات الكتابة.

16) قائمة التحقق من الاستعداد

• سياسة موحدة: أي استعادة، وما لا ؛ الرموز ومطالبات العملاء.
• تراجع أسي + نفث كامل ؛ 'retry _ budget' محدد.
• عقد «Idempotency-Key» + نتائج التخزين مع TTL.
• Outbox/Inbox للأحداث ؛ DLQ ؛ حدود تنافسية.
• التكامل مع قاطع الدائرة، احترام «إعادة المحاولة بعد».
• المقاييس/التنبيهات بواسطة Retray/Duplicate/Conflict.
• مجموعة من اختبارات الفوضى ومحاكاة فشل الشبكة.
• وثائق العملاء - أمثلة على النسخ الاحتياطية والأوضاع.

17) TL ؛ د

التراجعات مفيدة فقط مع الغباء. أدخل «Idempotency-Key» وتخزين النتيجة، وقم بتطبيق النسخ الاحتياطي الأسي مع ميزانية الترفيه وإعادة التجربة، واحترم «Retry-After»، واندمج مع قاطع الدائرة. للأحداث - صندوق الخروج/صندوق الوارد ؛ للمدفوعات والتفريغ الصارم والأقفال. قياس عمليات إعادة التدوير والتعارض، واختبار النسخ المكررة والمهل الزمنية.