SYNC151: استجابة المتجر مشوّهة

ماذا يعني هذا

أرسل متجرك استجابة مشوّهة اضطر WCPOS إلى إصلاحها قبل قراءتها.

عادةً ما يعني هذا أن إضافة أو إشعار PHP يطبع مخرجات إضافية داخل استجابات المتجر. وقد تعافى WCPOS من هذه الحالة، لكن الإصلاحات غير مضمونة — اطلب من مسؤول الموقع مراجعة سجل أخطاء الموقع.

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

يمكنك مواصلة العمل — فـ WCPOS يتولى هذا تلقائيًا. يعيد WCPOS محاولة هذا تلقائيًا.

بياناتك

لا تتأثر أي بيانات طلبات أو منتجات. وإذا استمر هذا، فاسأل الشخص الذي يدير موقع WordPress لديك.

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

1. تحقق مما إذا كان الطلب المرتبط قد نجح في النهاية. فإذا نجح، فقد أصلح WCPOS هذه الحالة؛ وإذا فشل، فاتبع إرشادات الخطأ وإعادة المحاولة الخاصة بذلك الطلب بدلًا من ذلك.
2. السبب في الموقع: إضافة أو قالب يطبع تحذيرات أو مخرجات دخيلة داخل استجابات REST. اطلب من مسؤول الموقع مراجعة سجلات الموقع بحثًا عن إشعارات PHP في وقت حدوث العطل.
3. يعرض فاحص الشبكة نص الاستجابة الخام — إذ تظهر المخرجات الدخيلة مباشرة قبل JSON أو بعده.
4. الإصلاحات تُبذل قدر المستطاع: فإذا تكررت هذه التحذيرات، فعالج الإضافة المسببة بدلًا من الاعتماد على الإصلاح.

أين تبحث

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

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

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

التفاصيل

• الرمز: SYNC151 (STORE_RESPONSE_MALFORMED)
• الخطورة: تحذير
• أُضيف في: WCPOS 1.10.0