كل المقالات التقنية

حل خطأ Error Establishing a Database Connection في ووردبريس

منهج تشخيص خطأ اتصال قاعدة بيانات ووردبريس من wp-config.php وحالة MySQL إلى حدود الاتصالات وإصلاح الجداول.

حل خطأ Error Establishing a Database Connection في ووردبريس

يعني خطأ Error Establishing a Database Connection أن PHP لم يتمكن من فتح اتصال صالح بقاعدة بيانات ووردبريس. لا تبدأ بتعديلات عشوائية. حدد أولاً هل العطل دائم أم متقطع، ثم اختبر المسار من إعدادات wp-config.php حتى حالة MySQL.

افحص خدمة قاعدة البيانات ومسار الشبكة

تحقق من MySQL أو MariaDB على خادم قاعدة البيانات. إذا كانت القاعدة بعيدة، افحص DNS والمنفذ 3306 وfirewall وbind-address.

systemctl status mariadb --no-pager
journalctl -u mariadb -n 100 --no-pager
ss -lntp | grep 3306

تحقق من wp-config.php بدون كشف الأسرار

راجع DB_NAME وDB_USER وDB_PASSWORD وDB_HOST. جرّب القيم نفسها من خادم PHP، واترك mysql يطلب كلمة المرور بدلاً من كتابتها في shell history.

mysql -u DB_USER -p -h DB_HOST DB_NAME

اعتبر الأعطال المتقطعة إشارة إلى السعة

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

mysql -e "SHOW STATUS LIKE 'Threads_connected'; SHOW VARIABLES LIKE 'max_connections';"
mysqladmin processlist

استخدم repair فقط عند وجود دليل على تلف الجداول

خذ backup أولاً. يمكن الوصول إلى صفحة إصلاح ووردبريس بدون login عند تفعيل WP_ALLOW_REPAIR، لذلك احذف الإعداد فور الانتهاء. مع InnoDB قد تكون مساحة القرص وcrash recovery أهم من repair التقليدي.

عالج السبب الجذري بعد عودة الخدمة

راجع مساحة القرص وOOM وtimeouts وضغط PHP workers والتغييرات الأخيرة. أضف health check لقاعدة البيانات وتنبيهاً لزمن الاستجابة.

قائمة استعادة آمنة

  • خذ نسخة احتياطية من القاعدة وwp-config.php.
  • احفظ حالة الخدمة والسجلات.
  • اختبر نفس host وuser يدوياً.
  • اربط الأعطال المتقطعة بعدد الاتصالات والذاكرة.
  • أزل وصول repair المؤقت فوراً.

أسئلة شائعة

هل كلمة المرور الخاطئة هي السبب دائماً؟

لا. توقف MySQL أو امتلاء القرص أو نفاد الاتصالات أو DNS وfirewall قد تعطي الرسالة نفسها.

هل restart لـ MySQL يكفي؟

قد يعيد الخدمة مؤقتاً، لكنه ليس حلاً كاملاً بدون فهم السجلات وضغط الموارد.

هل أرسل wp-config.php للدعم؟

لا. يحتوي على أسرار. شارك أسماء الإعدادات والخطأ بعد إزالة القيم الحساسة.

أدلة مرتبطة

توصي وثائق ووردبريس الرسمية بإزالة وصول إصلاح قاعدة البيانات المؤقت فور انتهاء العملية.