Lorixen.
AR

«الاستجابة ليست JSON صالحة» في محرر ووردبريس: أين الخلل؟

باختصار: رسالة «فشل التحديث. الاستجابة ليست استجابة JSON صالحة» في محرر ووردبريس تعني أن المحرر أرسل طلب الحفظ إلى الواجهة البرمجية REST للموقع، فعاد إليه شيء غير البيانات المتوقعة: صفحة خطأ، أو صفحة حظر من جدار حماية، أو تحذير PHP مطبوع قبل البيانات، أو تحويل. ابدأ بفتح رابط ‎/wp-json/‎ في المتصفح، ثم أداة «صحة الموقع»، ثم تبويب الشبكة في أدوات المطور لترى ما الذي عاد فعلاً. لا تعطل الواجهة البرمجية، لأن لوحة التحكم نفسها تعتمد عليها.

كيف تظهر المشكلة

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

ما يربك الناس أن الرسالة تتحدث عن JSON، وهي كلمة لا علاقة لها بما كانوا يفعلونه. لكنها في الواقع وصف دقيق لما حدث: المحرر انتظر بيانات منظمة، فوصله شيء آخر.

لماذا يحتاج المحرر إلى الواجهة البرمجية

محرر المكعبات في ووردبريس لا يرسل نموذجاً تقليدياً عند الحفظ، بل يتحدث مع الموقع عبر الواجهة البرمجية REST. بحسب دليل الواجهة البرمجية في ووردبريس، طلب GET إلى الرابط ‎/wp-json/‎ يعيد استجابة JSON تعرض المسارات المتاحة ونقاط النهاية في كل منها. وعند الحفظ، يرسل المحرر طلباً إلى أحد هذه المسارات وينتظر JSON في الرد.

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

الخطوة الأولى: افتح ‎/wp-json/‎

اكتب في المتصفح رابط موقعك متبوعاً بـ ‎/wp-json/‎. النتيجة تخبرك بالكثير:

  • نص طويل يبدأ بقوس معقوف: الواجهة تعمل على الأقل للقراءة، فالمشكلة غالباً في طلب الحفظ تحديداً.
  • صفحة خطأ 404: يذكر دليل ووردبريس أنه إذا ظهر خطأ 404 عند فتح ‎/wp-json/‎، ففكر في تفعيل الروابط الدائمة الجميلة، أو جرب المعامل rest_route بدلاً من ذلك، بصيغة ‎/?rest_route=/‎. إذا عمل الثاني ولم يعمل الأول، فالمشكلة في إعداد إعادة كتابة الروابط على الخادم.
  • صفحة حظر أو تحقق: جدار حماية أو إضافة أمان تحجب الطريق.
  • تحويل إلى نطاق أو بروتوكول آخر: إعداد عنوان الموقع لا يطابق العنوان الذي تعمل عليه.

الخطوة الثانية: أداة صحة الموقع

افتح «الأدوات» ثم «صحة الموقع» في لوحة التحكم. هذه الأداة تختبر الواجهة البرمجية وطلبات الموقع إلى نفسه، وتعرض المشاكل التي تجدها. يذكر دليل صحة الموقع مثلاً أن وجود جلسة PHP نشطة، أنشأها استدعاء session_start، يتعارض مع طلبات الواجهة البرمجية وطلبات الموقع إلى نفسه، وأن الجلسة يجب أن تُغلق قبل أي طلبات HTTP. هذا يحدث مع بعض الإضافات المكتوبة بشكل سيئ، ويظهر بهذه الرسالة بالضبط.

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

الخطوة الثالثة: انظر إلى الرد الفعلي

هذه الخطوة تحسم المسألة في أغلب الحالات. في المتصفح، افتح أدوات المطور، ثم تبويب الشبكة، ثم اضغط «تحديث» في المحرر. ابحث عن الطلب الذي فشل، وافتح تبويب الاستجابة. ما تراه هناك هو ما وصل إلى المحرر بدل JSON:

  • صفحة HTML كاملة بشعار جدار حماية: الطلب حُجب قبل أن يصل إلى ووردبريس.
  • سطر Warning أو Notice ثم JSON: إضافة أو قالب يطبع تحذيراً قبل البيانات، فيكسر صيغتها.
  • رد فارغ أو خطأ 500: خطأ فادح في PHP، والتفاصيل في سجل الأخطاء.
  • رمز 403: صلاحيات أو إضافة أمان أو قاعدة في الخادم.

الأسباب الشائعة وعلاجها

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

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

الروابط الدائمة وإعادة الكتابة: إذا كان ‎/wp-json/‎ يعيد 404، فافتح إعدادات الروابط الدائمة واحفظها مرة دون تغيير، فهذا يعيد كتابة القواعد على Apache. وعلى nginx تأكد أن إعداد try_files يمرر الطلبات إلى index.php مع المعاملات.

عنوان الموقع: إذا كان عنوان ووردبريس في الإعدادات http بينما تعمل على https، أو بنطاق مختلف، فقد يتحول الطلب ويفشل. اجعل العنوانين في الإعدادات العامة مطابقين للعنوان الفعلي.

تعطيل الواجهة البرمجية بإضافة: بعض إضافات «تسريع» أو «حماية» تقدم خيار تعطيل الواجهة البرمجية. أطفئ هذا الخيار، واستخدم بدلاً منه اشتراط تسجيل الدخول إن أردت.

إذا كانت الرسالة تظهر عند رفع الصور

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

طريقة سريعة لعزل السبب

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

مثال توضيحي: موقع مدرسة خاصة

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

أسئلة شائعة

شو معنى الاستجابة ليست استجابة JSON صالحة بووردبريس؟

يعني أن المحرر طلب الحفظ من الواجهة البرمجية فعاد إليه رد غير متوقع، مثل صفحة خطأ أو حظر أو تحذير PHP.

هل بعطل REST API لأنها هي المشكلة؟

لا. دليل ووردبريس يقول إن تعطيلها يكسر وظائف لوحة التحكم. ابحث عن سبب فشل الطلب بدلاً من ذلك.

الرسالة بتطلع بس مع بعض المقالات، ليش؟

غالباً جدار حماية يشك في محتوى معين مثل كود تضمين أو روابط كثيرة. استثنِ مسارات الحفظ للمستخدمين المسجلين.

كيف بعرف شو الرد اللي وصل للمحرر؟

من أدوات المطور في المتصفح، تبويب الشبكة، افتح الطلب الفاشل واقرأ الاستجابة.

إذا كان محرر موقعك يرفض الحفظ ولا تعرف من أين تبدأ، راسلنا ونتتبع الطلب الفاشل معك حتى نجد سببه الحقيقي.

المصادر

WhatsAppاحجز مكالمة