Lorixen.
AR

مهام WooCommerce العالقة: طابور Action Scheduler لا يعمل

باختصار: إذا كانت رسائل الطلبات في متجر WooCommerce تتأخر، أو مزامنة المخزون مع نظام آخر تتوقف، أو مهام الإضافات لا تعمل في وقتها، فافتح شاشة «Scheduled Actions» من WooCommerce ثم Status. إذا رأيت مئات أو آلاف المهام في حالة Pending وتواريخها في الماضي، فطابور Action Scheduler لا يُعالج. هذا الطابور يُشغَّل افتراضياً عبر WP-Cron، لذلك يتعطل حين لا يعمل WP-Cron جيداً. الحل: افهم أي مهام عالقة ولماذا، ثم شغّل الطابور بطريقة يعتمد عليها مثل WP-CLI من مهمة مجدولة على الخادم.

الأعراض التي تقود إلى هذه الشاشة

متجر ملابس في عمّان يبيع عبر موقع WooCommerce، أو متجر قطع غيار في الزرقاء يربط مخزونه بنظام المستودع. الأعراض تأتي متفرقة ولا يربطها صاحب المتجر ببعضها في البداية:

  • الزبون لا يستلم رسالة تأكيد الطلب إلا بعد ساعات، أو لا يستلمها أبداً.
  • كمية منتج في الموقع لا تتغير بعد البيع، مع أن إضافة المزامنة مفعلة.
  • تقارير أو تصديرات مجدولة لا تصل.
  • إضافة تسويق أو ربط مع منصة إعلانات تعرض تحذيراً بأن البيانات قديمة.
  • لوحة التحكم بطيئة، وقاعدة البيانات أكبر مما يجب.

كثير من الإضافات في عالم WooCommerce لا تنفذ هذه الأعمال فوراً عند الحدث، بل تضعها في طابور مهام اسمه Action Scheduler، لتُنفذ في الخلفية. فإذا توقف الطابور، توقفت كلها معاً.

ما هو Action Scheduler

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

ومنذ النسخة 3.0 يخزن بياناته في جداول خاصة تبدأ أسماؤها بـ actionscheduler_. وهذا يفسر لماذا يمكن أن يكبر حجم قاعدة البيانات حين تتراكم المهام.

افتح شاشة المهام المجدولة

يذكر التوثيق أن للأداة شاشة إدارة مدمجة لمراقبة المهام وتصحيحها وتشغيلها يدوياً، تصل إليها من Tools ثم Scheduled Actions، أو من WooCommerce ثم Status ثم Scheduled Actions عند تثبيت WooCommerce. من هذه الشاشة تستطيع:

  • عرض المهام حسب حالتها، مثل المهام الفاشلة أو قيد التنفيذ.
  • قراءة سجل كل مهمة لمعرفة سبب فشلها.
  • ترتيب المهام حسب اسم الخطاف أو التاريخ المجدول أو المجموعة أو الحالة.
  • البحث عن مهام حسب الخطاف أو المعاملات.
  • تشغيل مهمة معلقة يدوياً.

ابدأ بتبويب Pending ورتّب حسب التاريخ المجدول. إذا كانت أقدم مهمة معلقة منذ أيام، فالمشكلة في التشغيل. ثم افتح تبويب Failed واقرأ السجلات، لأن المهام الفاشلة لها سبب مختلف: خطأ في الإضافة نفسها، أو خدمة خارجية رفضت الطلب.

لماذا يتوقف الطابور

يوضح التوثيق أن Action Scheduler يُشغَّل افتراضياً عبر WP-Cron، وعبر خطاف shutdown في طلبات لوحة التحكم، مع أنه لا يعتمد عليه نظرياً. وWP-Cron لا يعمل إلا عندما يزور أحدٌ الموقع. الأسباب المعتادة للتوقف:

  • WP-Cron معطل في الإعدادات دون أن تكون هناك مهمة بديلة على الخادم.
  • حماية أو جدار ناري يمنع الطلبات التي يرسلها الموقع إلى نفسه.
  • حدود الوقت والذاكرة. يذكر التوثيق أن المعالجة الافتراضية تتوقف عند استخدام 90% من الذاكرة المتاحة، أو حين يتوقع أن تتجاوز ثلاث مهام إضافية 30 ثانية من وقت الطلب. على استضافة ضعيفة ومع مهام ثقيلة، تُعالج المهام أبطأ مما تُضاف.
  • إضافة واحدة تغرق الطابور بآلاف المهام المتكررة، فتتأخر مهام الإضافات الأخرى خلفها.

اعرف أي إضافة صاحبة المهام

أسماء الخطافات والمجموعات في الشاشة تدلك على المصدر. المهام التي تبدأ أسماؤها بـ woocommerce تأتي غالباً من المتجر نفسه، والباقي يحمل عادة اسم الإضافة أو اختصاره. رتّب المهام المعلقة حسب الخطاف، واكتب عدد كل نوع. إذا كان نوع واحد يمثل الأغلبية الساحقة، فهو المتهم الأول: إما أن الإضافة تضيف مهام أكثر من اللازم، أو أن مهامها تفشل وتعيد جدولة نفسها. في هذه الحالة تواصل مع مطور الإضافة أو راجع إعداداتها قبل أي شيء آخر، لأن تسريع الطابور وحده لن يكفي.

شغّل الطابور بطريقة يعتمد عليها

يقول التوثيق إن WP-CLI خيار أفضل بكثير من مشغل WP-Cron الافتراضي للمواقع الكبيرة، خاصة مع المهام الطويلة والطوابير الكبيرة والإضافات التي تستخدم WP-Cron كثيراً، لأن الطلب العادي قد يصطدم بحدود الوقت التي يفرضها المستضيف. الأمر الأساسي هو:

wp action-scheduler run --batch-size=100

ويذكر التوثيق أن الخيار ‎--batches=0‎ يجعل الدفعات تستمر حتى لا تبقى مهام، وأن ‎--group‎ و‎--hooks‎ تحصر المعالجة في مجموعة أو خطاف محدد.

إذا كان عندك خادم خاص، ضع هذا الأمر في مهمة مجدولة على الخادم كل دقيقة أو بضع دقائق. وانتبه للتحذير في التوثيق: إذا عطلت المشغل الافتراضي لتعتمد على WP-CLI وحده، فيجب أن يعمل WP-CLI فعلاً، وإلا لن تُعالج أي مهمة.

وإذا لم يتوفر WP-CLI، يذكر التوثيق إمكانية رفع حد الوقت عبر الفلتر action_scheduler_queue_runner_time_limit، بشرط أن تكون متأكداً أن استضافتك تسمح بطلبات أطول.

نظّف بعد أن يعمل

بعد أن يعود الطابور للعمل، قد تبقى في الجداول آلاف المهام المكتملة القديمة. أمر التنظيف في WP-CLI هو action-scheduler clean، ويذكر التوثيق أنه افتراضياً يحذف المهام الملغاة والمكتملة الأقدم من 31 يوماً، مع إمكانية تحديد الحالة والمدة. لا تحذف المهام المعلقة قبل أن تفهم ما هي، فقد تكون رسائل أو مزامنات لم تُنفذ بعد.

راقبه حتى لا تكتشفه من الزبائن

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

مثال توضيحي: متجر برسائل متأخرة

هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. متجر ملابس يلاحظ أن رسائل الطلبات تتأخر. في شاشة Scheduled Actions يجد آلاف المهام المعلقة، أقدمها منذ أسبوع، معظمها من إضافة مزامنة منتجات. يكتشف أن WP-Cron معطل في الإعدادات منذ نقل الموقع، دون مهمة بديلة. يضيف مهمة على الخادم تشغّل أمر WP-CLI كل دقيقتين، ويراقب الطابور حتى يفرغ، ثم يقرأ سجلات المهام الفاشلة القليلة، وينظف المكتمل القديم.

أسئلة شائعة

وين بلاقي المهام المجدولة بووكومرس؟

من WooCommerce ثم Status ثم Scheduled Actions، أو من Tools ثم Scheduled Actions.

شو يعني إنو في آلاف المهام Pending؟

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

بقدر أحذف المهام المعلقة وخلص؟

لا تفعل ذلك قبل أن تعرف ما هي، فقد تكون رسائل أو مزامنات لم تُنفذ. أصلح التشغيل أولاً.

ليش WP-CLI أفضل من WP-Cron للطابور؟

لأنه يعمل مباشرة على الخادم دون قيود الطلب العادي، ويوصي به التوثيق للطوابير الكبيرة.

إذا كانت رسائل متجرك أو مزامناته متأخرة ولا تعرف السبب، احجز مراجعة ونفحص طابور المهام وطريقة تشغيله.

المصادر

WhatsAppاحجز مكالمة