SYNC131: خطأ في خادم المتجر

ماذا يعني هذا

أرجع متجرك خطأً، لذا لم يكتمل هذا الإجراء.

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

ما الذي ينبغي فعله

جرّب الإجراء مرة أخرى. لا يعيد WCPOS محاولة هذا من تلقاء نفسه — أعد المحاولة عندما تكون مستعدًا.

بياناتك

التغيير محفوظ على هذا الجهاز لكنه لم يصل إلى متجرك. وإذا استمر هذا، فصدّر التشخيصات وتواصل مع دعم WCPOS.

استكشاف الأخطاء

1. وسّع إدخال السجل ودوّن الحالة ونقطة النهاية و serverCode — فهي تبيّن ما كان الخادم يفعله عند حدوث العطل.
2. افتح WooCommerce → الحالة → السجلات على الموقع وراجع أحدث سجل fatal-errors حول وقت حدوث العطل؛ فالاستجابة من فئة 500 تترك خطأ PHP هناك في معظم الحالات.
3. إذا بدأ العطل بعد تحديث إضافة أو قالب أو PHP على الموقع، فاشتبه في ذلك التغيير أولًا وتراجع عنه أو عطّله.
4. إذا لم تُظهر سجلات WooCommerce شيئًا، فاطلب من مزوّد الاستضافة سجل أخطاء PHP الخاص بالخادم للفترة الزمنية نفسها.
5. بمجرد إصلاح السبب على جانب الخادم، أعد المحاولة من POS — فالتغيير لا يزال محفوظًا على هذا الجهاز.

أين تبحث

عندما يتمكن WCPOS من حفظ هذا الخطأ، يُسجَّل على الجهاز الذي أثاره. افتح صحة المتجر → السجلات (رمز نبض القلب أسفل درج التنقل)، وابحث عن الإدخال المعلَّم بهذا الرمز ووسّعه: يعرض الصف الموسّع السبب بلغة واضحة والسياق الذي التُقط لحظة حدوث العطل. وفي حالة طلب موجّه إلى المتجر، قد يشمل ذلك السياق رمز الخطأ الخاص بالخادم (serverCode)، أو حالة HTTP (status)، أو نقطة النهاية (endpoint)؛ وتعتمد الحقول المعروضة على موضع حدوث العطل. وعند الإبلاغ عن مشكلة، استخدم نسخ معلومات التصحيح أعلى شاشة السجلات (مشاركة معلومات التصحيح على الهواتف والأجهزة اللوحية) بدلًا من لقطات الشاشة: فهي تجمع إصدار التطبيق وحالة الاتصال وأحدث الأخطاء. وتُحفظ السجلات لمدة أقصاها 30 يومًا، لذا اجمعها بينما المشكلة لا تزال حديثة. وانسخ أيضًا أي خطأ في وحدة تحكم المتصفح ظهر قبل أن يتمكن POS من كتابة إدخال السجل الخاص به.

إلى جانب السجل داخل التطبيق، قد يترك هذا العطل أثرًا في:

• فاحص الشبكة (Network) (الويب وسطح المكتب): افتح أدوات المطوّر — اضغط F12 في المتصفح، أو متقدّم → تبديل أدوات المطوّر في قائمة تطبيق سطح المكتب — ثم اختر تبويب Network. اتبع إرشادات إعادة المحاولة الواردة في هذه الصفحة أولًا؛ ولا تُعِد تنفيذ الإجراء إلا عندما تؤكد تلك الخطوات أن ذلك آمن. ويعرض الطلب الفاشل حالة HTTP ونص الاستجابة الخام، بما في ذلك صفحات الأخطاء التي لا تصل إلى سجل POS أبدًا.
• سجلات POS على الخادم: في WP Admin، افتح POS → الإعدادات → الأدوات → السجلات. تسجّل هذه الصفحة التحذيرات والأخطاء المتعلقة بـ POS التي تنشأ على الخادم نفسه، وقد لا تظهر داخل التطبيق أبدًا. وتعني الشارة الحمراء على القائمة وجود أخطاء غير مقروءة على الخادم.
• WooCommerce → الحالة → السجلات: في موقع WordPress، راجع أحدث ملف fatal-errors-*.log بحثًا عن أعطال PHP، إضافة إلى أي مصدر سجل يحمل اسم إضافة متورطة في العطل. فالخطأ من فئة 500 القادم من المتجر يترك سببه هنا في معظم الحالات.
• سجل أخطاء PHP الخاص بالموقع: إذا لم تُظهر صفحة سجلات WooCommerce شيئًا في وقت حدوث العطل، فاطلب من مزوّد الاستضافة سجل أخطاء PHP — إذ لا تُلتقط بعض الأخطاء الفادحة إلا على مستوى الخادم.

التفاصيل

• الرمز: SYNC131 (STORE_SERVER_ERROR)
• الخطورة: خطأ
• أُضيف في: WCPOS 1.10.0