قد يعمل سير الأتمتة عدة أيام ثم يتوقف بسبب بيانات ناقصة أو خدمة خارجية غير متاحة. المشكلة ليست ظهور الخطأ فقط، بل عدم معرفة أين حدث وما الذي تم تنفيذه قبله. معالجة الأخطاء في n8n تبدأ بتشخيص واضح، ثم مسار يخبرك بالفشل، ثم قرار مدروس بشأن إعادة التشغيل. هذا الدليل يركز على بناء روتين قابل للاختبار بدل إخفاء الخطأ والاستمرار دون مراجعة.
ابدأ من التنفيذ الذي فشل
راجع قسم Executions وحدد التنفيذ المقصود ووقت حدوثه. افتح العقدة التي توقفت واقرأ المدخلات ورسالة الخطأ. دوّن اسم العملية والعقدة ونوع البيانات التي وصلت إليها. قبل أي تعديل، اسأل: هل الخطأ من الاتصال، أم من الصلاحيات، أم من شكل البيانات، أم من منطق سير العمل؟
مثال افتراضي: سير عمل يقرأ قائمة مقالات، ينظف العناوين، ثم يضيفها إلى جدول. إذا كان أحد العناصر بلا عنوان، فإعادة تشغيل الطلب الخارجي قد لا تفيد؛ المشكلة في التحقق من البيانات. وإذا توقفت الخدمة الخارجية مؤقتًا، فقد تكون إعادة المحاولة مفيدة بعد التأكد من عدم تكرار الكتابة.
إعداد Error Workflow
توضح وثائق n8n أن مسار الأخطاء يبدأ بعقدة Error Trigger، ويُربط بسير العمل الرئيسي من إعداداته. يمكن استخدام المسار نفسه لأكثر من سير عمل.
- أنشئ سير عمل منفصلًا وسمّه اسمًا واضحًا، مثل «متابعة أخطاء الأتمتة».
- اجعل أول عقدة فيه Error Trigger، ثم احفظه.
- افتح إعدادات سير العمل الرئيسي، وحدد المسار الجديد في خيار Error workflow.
- احفظ الإعدادات وأضف في مسار الأخطاء معالجة مناسبة، مثل تسجيل ملخص أو تنبيه إلى وجهة تختارها.
قد تتضمن بيانات الخطأ اسم سير العمل ورسالة الخطأ والعقدة الأخيرة ورابط التنفيذ. بعض الحقول تختلف عند فشل المشغّل أو عدم حفظ التنفيذ، لذلك لا تبنِ رسالة تفترض وجود كل حقل دائمًا. استخدم قيمة بديلة للمعلومة المفقودة.
ماذا تكتب في التنبيه؟
التنبيه المفيد يختصر ما تحتاجه للتحقيق: اسم سير العمل، وقت الحدث، العقدة التي فشلت، ورسالة مختصرة. أضف رابط التنفيذ إن كان موجودًا ومتاحًا للمستلم المصرح له. تجنب إرسال كامل البيانات الداخلة في كل مرة؛ فقد تحتوي تفاصيل لا يحتاجها الشخص الذي سيتابع المشكلة.
صيغة تجريبية: «فشل سير أرشفة المقالات. العقدة: إضافة الصف. السبب: حقل العنوان مفقود. الإجراء المقترح: مراجعة العنصر قبل إعادة التشغيل». المثال لا يمثل سجلًا حقيقيًا، ويمكنك تعديله ليناسب مهمتك. الهدف أن يستطيع المستلم فهم الخطوة التالية دون قراءة سجل طويل.
الفرق بين الخطأ المؤقت والخطأ الدائم
الخطأ المؤقت قد يرتبط بانقطاع اتصال أو ضغط على خدمة، أما الخطأ الدائم فقد يكون قيمة غير صالحة أو حقلًا مطلوبًا مفقودًا أو صلاحية غير متاحة. لا تجعل قرار إعادة المحاولة يعتمد على التخمين؛ اقرأ رسالة الخدمة وتوثيقها، وراجع ما إذا كان الطلب وصل بالفعل.
إذا قررت إعادة المحاولة، حدد عددًا أقصى وفاصلًا زمنيًا مناسبًا وفق تعليمات الخدمة. أما البيانات غير الصحيحة، فضعها في قائمة مراجعة أو أوقف المعالجة حتى تُصحح. تكرار الطلب غير الصحيح لا يحل المشكلة وقد يزيد الضوضاء أو استهلاك الحدود.
منع تكرار العمليات عند إعادة التشغيل
قبل إعادة تنفيذ سير يحتوي كتابة في جدول أو إرسال رسالة، تحقق مما اكتمل سابقًا. قد تنجح خطوة ثم تفشل الخطوة التالية، وبالتالي تؤدي إعادة السير كله إلى إنشاء سجل إضافي. استخدم معرّفًا ثابتًا لكل عنصر وراجع وجوده في الوجهة قبل الإضافة، أو استفد من آلية منع التكرار التي توفرها الخدمة.
في مثال أرشفة المقالات، يمكن أن يكون معرّف المقال أساس المقارنة بدل العنوان؛ العنوان قد يتغير. دوّن حالة العنصر بعد نجاح العملية، وميز بين عنصر لم يبدأ وعنصر يحتاج إلى استكمال. هذا اقتراح تصميم يحتاج إلى تكييف مع وجهتك وطريقة حفظ البيانات.
اختبار مسار الأخطاء
توفر n8n عقدة Stop And Error لإحداث فشل مقصود عند شرط تختاره. استخدمها في نسخة تجريبية ببيانات وهمية، وراجع سلوك Error Trigger في إصدارك وطريقة تشغيله؛ لا تعتبر الضغط على تشغيل يدوي وحده دليلًا على اختبار مسار الخطأ التلقائي.
- حدد نتيجة متوقعة، مثل تسجيل تنبيه واحد باسم سير العمل الصحيح.
- نفذ حالة فشل تجريبية في البيئة المخصصة للاختبار.
- راجع سجل التنفيذ ومسار الأخطاء والوجهة النهائية.
- اختبر حالة فيها معلومة مفقودة للتأكد من عمل القيم البديلة.
- أزل سبب الفشل التجريبي، ثم اختبر نجاح المسار الطبيعي.
دوّن نتيجة كل حالة بدل الاكتفاء بأن التنبيه وصل مرة واحدة. تأكد أن مسار الأخطاء نفسه لا ينشئ حلقة من التنبيهات، وأن فشل وجهة التسجيل يمكن اكتشافه بطريقة مناسبة.
أخطاء يجب تجنبها
- الاستمرار بعد فشل خطوة أساسية وإظهار العملية كأنها ناجحة.
- إعادة كل التنفيذ دون مراجعة ما اكتمل.
- إرسال مفاتيح الوصول أو بيانات خاصة ضمن التنبيه.
- تعديل سير الإنتاج قبل حفظ نسخة وفهم سبب الفشل.
- الاعتماد على تنبيه غير مختبر بدل التحقق من السجلات.
أسئلة شائعة
هل Error Workflow يصلح الخطأ تلقائيًا؟
لا يصلح كل سبب بمجرد إعداده. تحدد أنت ما يفعله المسار بعد الفشل، وقد تكون النتيجة تسجيل المشكلة أو إحالتها للمراجعة.
هل أعيد المحاولة دائمًا؟
لا. راجع نوع الخطأ واحتمال تكرار الأثر وحدود الخدمة أولًا، ثم اختر إعادة محدودة أو تصحيح البيانات.
التعليقات