الأخطاء وإعادة المحاولة والآثار الجانبية
أعِد المحاولة تحت الحلقة لا داخلها
الإخفاقات العابرة في البنية التحتية — انتهاء المهلة، وحدود المعدل، والتعطل القصير — يجب أن تُعالَج داخل كود الأداة بتراجع تدريجي محدود، ولا تُعرض على النموذج أبدًا. فكل إعادة محاولة (Retry) يجريها النموذج تكلّف خطوة كاملة: استدعاء للنموذج، والسياق، وخطر أن يستجيب للفشل بتغيير نهجه بدل التكرار. احتفظ بالأخطاء المرئية للنموذج للحالات التي تتطلب قرارًا. وهناك تحفّظ جدير بالاحترام: إعادة المحاولة على الطبقتين تتراكب بشكل سيئ، فالوكيل الذي يعيد محاولة أداة تعيد المحاولة داخليًا قد يُنتج عددًا مفاجئًا من المحاولات على خدمة تابعة متعثرة أصلًا. حدّد طبقة إعادة المحاولة لكل أداة، ووثّقها في الوصف إن كانت تؤثر في التوقيت، وضع سقفًا لإجمالي المحاولات لكل أداة في كل تشغيل داخل بيئة التشغيل كي لا يتجاوزه أي تركيب للطبقات.
- عالج الإخفاقات العابرة داخل الأداة بتراجع تدريجي محدود، بعيدًا عن نظر النموذج
- كل إعادة محاولة مرئية للنموذج تكلّف خطوة كاملة وقد تدفعه إلى تغيير استراتيجيته
- لا تعرض إلا الأخطاء التي تتطلب قرارًا فعلًا
- ضع سقفًا لإجمالي المحاولات لكل أداة في كل تشغيل كي لا تتراكم إعادة المحاولة عبر الطبقات
عدم تكرار الأثر ليس اختياريًا هنا
الوكلاء يعيدون المحاولة، ويعيدونها بشكل غير حتمي، ما يجعل التنفيذ مرة واحدة على الأقل (At-least-once) هو الافتراض الصادق لأي أداة ذات أثر جانبي. وهذا يعني رسائل مكررة، ومدفوعات مكررة، وتذاكر مكررة، وسجلات مكررة، ما لم تُبنَ الأداة لمنع ذلك. والآلية المعيارية تنطبق: اشتقّ مفتاح عدم تكرار (Idempotency key) ثابتًا من معرّف التشغيل مضافًا إليه الفعل المنطقي، واجعل الأداة تسجّله، وأعِد النتيجة الأصلية عند التكرار بدل تنفيذ الفعل مرة أخرى. وتأكد أن المفتاح مشتق من القصد لا من المعاملات كما صاغها النموذج، لأن إعادة المحاولة بحقل نص حر أُعيدت صياغته يجب أن تُعرف على أنها الفعل نفسه. وحيث لا يقدّم النظام التابع أي دعم لعدم تكرار الأثر، نفّذ السجل في طبقة الأدوات لديك، لأن ترك هذا لحسن تقدير النموذج سيفشل في مرحلة ما.
- التنفيذ مرة واحدة على الأقل هو الافتراض الصادق لأي أداة ذات أثر جانبي
- مفتاح ثابت من معرّف التشغيل والفعل المنطقي؛ أعِد النتيجة الأصلية عند التكرار
- اشتقّ المفاتيح من القصد، لا من نص المعاملات كما صاغه النموذج
- إن لم يقدّم النظام التابع شيئًا، احتفظ بالسجل في طبقة الأدوات لديك
الآثار الجزئية والفعل المنجز نصفه
الموقف الذي يُنتج أسوأ الحوادث هو أداة تفشل بعد أن تنجز جزءًا من عملها: أُنشئ السجل، ولم يُرسل الإشعار، والخطأ الذي يتلقاه النموذج يقول إن العملية فشلت. فيعيد النموذج المحاولة منطقيًا، وإذا بالسجلات اثنان. صمّم الأداة لمنع ذلك. فضّل عملية ذرّية واحدة حيث يسمح النظام الأساسي بذلك. وحيث لا يسمح، اجعل الأداة تبلّغ بما حدث بالضبط بدل فشل ثنائي — أُنشئ، لم يُبلَّغ، وهذا هو المعرّف — كي يُكمل الفعل التالي العمل بدل أن يبدأ من جديد. وحيث يتعذر حقًا جعل الفعل ذرّيًا أو غير مكرر الأثر، أتِح الفعل التعويضي كأداة واذكر ذلك في الوصف، لأن الوكيل القادر على التراجع عن أثر جزئي في وضع أفضل بكثير من وكيل خياره الوحيد أن يحاول مجددًا.
- أسوأ الحوادث تأتي من إخفاقات بعد إنجاز جزئي، يُبلَّغ عنها كفشل كامل
- فضّل العمليات الذرّية؛ وحيث يتعذر ذلك، بلّغ بالضبط بما حدث وما لم يحدث
- أعِد المعرّفات عند النجاح الجزئي كي تُكمل الخطوة التالية العمل بدل أن تبدأ من جديد
- أتِح الأفعال التعويضية كأدوات حيث لا تتوفر الذرّية ولا عدم تكرار الأثر