حل أخطاء ووردبريس الشائعة: الشاشة البيضاء وخطأ 500 وقاعدة البيانات

كان الموقع يعمل بالأمس واليوم لا يعرض إلا صفحة بيضاء أو رسالة «There has been a critical error on this website». ردّ الفعل الأول عادةً التخمين: مسح التخزين المؤقت، أو إعادة تثبيت ووردبريس، أو تغيير القالب.

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

ما أول ما نفعله عند خطأ في ووردبريس؟#

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

كيف نفعّل سجل أخطاء ووردبريس بأمان؟#

بثلاثة ثوابت في wp-config.php تكتب الخطأ في ملف ولا تعرضه للزائر. ضع هذه الأسطر فوق سطر نهاية التحرير، وإن كان WP_DEBUG موجودًا أصلًا فغيّر قيمته فقط:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', '/home/USERNAME/wp-errors.log' );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', '0' );

قيمة WP_DEBUG_LOG مسار ملف خارج public_html، لأن المسار الافتراضي wp-content/debug.log يمكن رؤيته من الخارج. بدّل USERNAME باسم مستخدم cPanel.

المكان الثاني سجل الاستضافة نفسها. يكتب cPanel عادةً أخطاء PHP في ملف باسم error_log في المجلد الذي وقع فيه الخطأ، وقسم Errors في cPanel يعرض آخر أخطاء خادم الويب. بعد معرفة السبب أعد WP_DEBUG إلى false.

كيف نحل الشاشة البيضاء أو «الخطأ الحرج»؟#

في معظم الحالات بتعطيل الإضافة أو القالب الذي ذكر سجل الأخطاء اسمه. في نص الخطأ ابحث عن مسار مثل wp-content/plugins/اسم-الإضافة/؛ تلك الإضافة هي السبب.

1. في File Manager ادخل إلى wp-content/plugins.
2. غيّر اسم مجلد الإضافة المتسببة، مثلًا أضف -off في آخره.
3. أعد تحميل الموقع. إن عاد فالسبب تلك الإضافة.
4. إن لم يُعرف السبب فغيّر اسم مجلد plugins كله مؤقتًا، وادخل إلى لوحة التحكم، وأعد الاسم، وفعّل الإضافات واحدة واحدة.
5. إن كان الخطأ من القالب فغيّر اسم مجلد القالب في wp-content/themes؛ فيعود ووردبريس إلى أحد القوالب الافتراضية المثبتة.

سببان شائعان آخران: تغيير إصدار PHP الذي لا تتوافق معه إضافة قديمة، ونفاد الذاكرة برسالة Allowed memory size exhausted. للأول أعد إصدار PHP مؤقتًا من Select PHP Version وحدّث الإضافة أو استبدلها. وللثاني، قبل زيادة الذاكرة انظر أي إضافة تستهلكها.

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

من أين يأتي خطأ 500 في ووردبريس؟#

من ملف .htaccess تالف، أو خطأ PHP قاتل، أو صلاحيات ملفات خاطئة. خطأ 500 يعني أن الخادم تعثر في تنفيذ الطلب لكنه لا يخبر المتصفح بالتفاصيل؛ والتفاصيل في error_log.

• .htaccess: غيّر اسمه إلى .htaccess-old. إن عاد الموقع فاضغط حفظ دون تغيير في الإعدادات ← الروابط الدائمة ليُنشئ ووردبريس ملفًا جديدًا، وأعد قواعدك الإضافية واحدة واحدة.
• صلاحيات الملفات: الملفات 644 والمجلدات 755. الصلاحية 777 تعطي بنفسها خطأ 500 في كثير من الاستضافات المشتركة.
• إعداد غير مسموح: أسطر مثل php_value في .htaccess غير مسموحة في بعض الاستضافات؛ اضبط إعدادات PHP من قسم Select PHP Version.

ما سبب خطأ الاتصال بقاعدة البيانات؟#

الرسالة Error establishing a database connection تعني أن ووردبريس لم يستطع الاتصال بقاعدة البيانات بمعلومات wp-config.php. الأسباب بحسب الاحتمال:

لأداة الإصلاح أضف هذا السطر مؤقتًا إلى wp-config.php، وافتح العنوان /wp-admin/maint/repair.php من موقعك ونفّذ الإصلاح:

define( 'WP_ALLOW_REPAIR', true );

صفحة الإصلاح متاحة دون تسجيل دخول. احذف هذا السطر فور انتهاء الإصلاح.

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

ما الأخطاء الشائعة الأخرى في ووردبريس؟#

ستة أخطاء أخرى لكل منها سبب ثابت تقريبًا ويمكن تشخيصها حتى دون سجل أخطاء:

لإعادة التوجيه المفرطة انظر HTTPS والمحتوى المختلط على cPanel، ولخطأ 508 خطأ 508 وسقف موارد الاستضافة.

كيف نستعين بالذكاء الاصطناعي في تشخيص الأخطاء؟#

أعطه آخر أسطر سجل الأخطاء وإصدار PHP وووردبريس وما جرّبته حتى الآن. قبل الإرسال امسح كلمة مرور قاعدة البيانات والمفاتيح وعناوين البريد من النص. الطريقة الكاملة في تصحيح الأخطاء بالذكاء الاصطناعي.

إلى أين يتجه تشخيص أخطاء ووردبريس#

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

لتكون مستعدًا:

• حدّد مسار سجل الأخطاء من الآن خارج public_html ليكون جاهزًا يوم الخطأ.
• جرّب ترقية PHP والتحديثات الكبيرة أولًا على بيئة تجريبية.
• أبقِ بريد المدير حقيقيًا لتصلك رسالة وضع الاسترداد.
• استبدل الإضافات التي لم تُحدَّث منذ مدة ببدائل نشطة.

الخلاصة#

• لا تخمّن؛ اعثر أولًا على نص الخطأ الدقيق في السجل.
• اكتب سجل الأخطاء في ملف خارج public_html ولا تعرضه على الصفحة.
• عطّل الإضافة المتسببة بتغيير اسم مجلدها في File Manager.
• خطأ 500: افحص .htaccess وخطأ PHP وصلاحيات الملفات.
• خطأ قاعدة البيانات: معلومات wp-config.php وربط المستخدم بقاعدة البيانات.