تعتمد إضافات WooCommerce على مهام خلفية لإرسال الرسائل، وتجديد الاشتراكات، وتحديث المخزون، ومزامنة خدمات خارجية. عندما تتأخر مهام WooCommerce المجدولة قد يظهر الطلب مكتملًا في الواجهة بينما يبقى بريد أو مزامنة أو إجراء دفع عالقًا. التشخيص الصحيح يبدأ من حالة المهمة وسجلها، لا من تشغيل كل المهام يدويًا.
يمكن مراجعة البنية ضمن خدمة إنشاء متجر WooCommerce. وإذا كان الأثر يظهر في رسائل الطلبات، اقرأ دليل منع تكرار بريد الطلبات عند استخدام الطوابير.
أين تجد المهام وما معنى حالاتها؟
توضح وثائق WooCommerce الرسمية للمهام المجدولة أن الشاشة توجد عادة في WooCommerce ثم الحالة ثم Scheduled Actions. تعرض حالات مثل pending وcomplete وfailed وcanceled وin-progress، مع اسم hook وموعد التشغيل والمجموعة والسجل.
المهمة pending ليست خطأ بمجرد وجودها؛ قد يكون وقتها لم يحن. أما failed فتحتاج قراءة الرسالة، وin-progress لفترة طويلة قد تشير إلى عملية انقطعت أو قفل لم يتحرر. ابحث بالـ hook أو المجموعة حتى تربط المهمة بالإضافة المسؤولة قبل التعديل.
افحص السجل قبل التشغيل اليدوي
يعرض المستودع الرسمي لـ Action Scheduler إمكانية فرز المهام والبحث فيها وقراءة السجلات وتشغيل مهمة يدويًا. استخدم التشغيل اليدوي لمهمة واحدة بعد فهم أثرها، لأن تشغيل دفعة كبيرة قد يرسل رسائل مكررة أو يعيد مزامنة بيانات بكثافة.
اقرأ السجل من الأقدم إلى الأحدث: وقت الإنشاء، المحاولات، بدء التنفيذ، ورسالة الفشل. ثم راجع سجل PHP وWooCommerce في التوقيت نفسه. رمز خطأ شبكة يختلف عن نفاد ذاكرة أو استثناء برمجي أو صلاحية API منتهية.
خطوات تشخيص آمنة
- اختر hook واحدًا متأثرًا، وحدد الإضافة التي أنشأته، وعدد المهام المتراكمة وأقدم موعد. لا تبدأ بحذف الصفوف.
- افتح سجل مهمة فاشلة واحدة، واربط رسالتها بسجل الخادم وبحالة الخدمة الخارجية. أصلح السبب مثل مفتاح منتهي أو مهلة أو خطأ PHP.
- شغّل مهمة اختبار واحدة، وراقب الأثر الفعلي. إذا نجحت، دع العامل يعالج المتبقي تدريجيًا مع مراقبة المعدل والتكرار.
إذا فشلت المهمة مباشرة بعد الإصلاح، احتفظ بالرسالة الجديدة؛ قد تكون هناك طبقتان من الأخطاء. ولا تحول الحالة يدويًا إلى complete لأن ذلك يخفي العمل غير المنفذ.
ما علاقة WP-Cron بالتأخير؟
يعتمد WordPress افتراضيًا على الزيارات لتشغيل WP-Cron، ولذلك قد تتأخر المهام في متجر قليل الزيارات أو بيئة تحجب طلب loopback. افحص Site Health وطلب cron وحالة DISABLE_WP_CRON. إذا كان cron الداخلي معطلًا، تأكد من وجود cron حقيقي في الخادم بتواتر مناسب.
لا تشغّل cron كل ثانية من دون حاجة. راقب مدة الدفعات واستهلاك الذاكرة وحدود خدمات الدفع والشحن. قد يكون الحل زيادة استقرار العامل أو تقليل دفعة المعالجة، لا زيادة التواتر فقط.
مثال افتراضي
«مثال افتراضي»: تراكمت مهام مزامنة الشحن بحالة failed بعد انتهاء رمز API. حدّد الفريق hook الخاص بالإضافة، ووجد رسالة 401 في السجل. جدد الاتصال ثم شغّل مهمة واحدة لطلب تجريبي، فتحولت إلى complete ووصل رقم التتبع مرة واحدة. بعد ذلك راقب الطابور وهو يعالج المتبقي على دفعات، من دون الضغط على Run لكل الصفوف أو إعادة إرسال الرسائل.
لا يثبت نجاح مهمة واحدة أن كل الأنواع سليمة؛ افحص كل hook متأثر على حدة.
متى تحتاج تدخل المطور؟
إذا تكررت المهمة نفسها بلا حد، أو احتوت الحمولة بيانات غير صحيحة، أو بقيت in-progress مع أقفال طويلة، فراجع كود الإضافة وإصدارها. اختبر في staging قبل تحديث إضافة حرجة. اجمع hook ومعرف المهمة والرسالة والوقت وإصدارات WordPress وWooCommerce من دون مفاتيح أو بيانات عملاء.
احفظ نسخة احتياطية قبل حذف مهام أو تعديل الجداول. حذف الطابور قد يزيل دليل المشكلة ويترك آثارًا لم تكتمل.
قائمة مراجعة
- [ ] حُدد hook والإضافة المسؤولة.
- [ ] فُرق بين pending وfailed وin-progress.
- [ ] قُرئ سجل المهمة وسجل الخادم في الوقت نفسه.
- [ ] فُحص WP-Cron أو cron الحقيقي.
- [ ] أُصلح السبب قبل إعادة التشغيل.
- [ ] شُغلت مهمة واحدة للاختبار.
- [ ] تمت مراقبة التكرار وحدود الخدمات الخارجية.
- [ ] لم تُحذف المهام قبل النسخ والتحليل.
المصادر الرسمية
تمت مراجعة وثائق WooCommerce للمهام المجدولة والمستودع الرسمي لـ Action Scheduler. تختلف أسماء hooks باختلاف الإضافات، لذلك ارجع إلى وثيقة الإضافة المسؤولة أيضًا.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك