تشخيص Error establishing a database connection بأربع تجارب اتصال

ظهرت لك رسالة Error establishing a database connection بدل موقعك؟ معناها أن ووردبريس لم يتمكن من الاتصال بقاعدة البيانات، لكنها لا تخبرك بالسبب. سنقسم الاحتمالات إلى خطوات واضحة: تشغيل الخدمة، عنوان الاتصال، اسم القاعدة، ثم بيانات المستخدم، بدل تغيير كل شيء دفعة واحدة.

قاعدة البيانات تحتفظ بالمقالات والإعدادات، وملف wp-config.php يحمل بيانات الوصول إليها. رموز الأخطاء التالية تساعدك أو تساعد الدعم على تحديد موضع العطل؛ لا تحتاج إلى حفظها، ولا إلى نشر كلمة المرور مع صورة الخطأ.

ابدأ من نص الخطأ الذي ظهر لك

1. 2002 أو مهلة: افحص تشغيل MySQL والعنوان والمنفذ والجدار الناري.
2. 1049: اسم القاعدة غير موجود على ذلك الخادم أو يحتوي بادئة حساب لم تكتبها.
3. 1045 أو خطأ مصادقة قريب: راجع المستخدم وكلمة المرور واسم المضيف المسموح له.
4. الاتصال يعمل لكن ووردبريس لا يعمل: افحص بادئة الجداول ووجود جداول WordPress ثم الإضافات والسجلات.

كيف تختبر دون كسر الموقع؟

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

قراءة الحالات الأربع بتفصيل أكبر

الاتصال الصحيح: لم نكتف بأن الخادم قبل الاتصال؛ طلبنا منه معلومات عن جداول قاعدة المشروع ووجدنا 12 جدولا. هذا يثبت أن الخادم والاعتماد واسم القاعدة يعملون معا.

المنفذ الخاطئ: استغرقت المحاولة قرابة مهلة الثانيتين ثم عادت 2002. إذا كان الفشل فوريا أو أبطأ كثيرا، راجع DNS والجدار الناري وإعداد مهلة PHP بدل افتراض أن كلمة المرور خطأ.

القاعدة المفقودة: عاد 1049 خلال أجزاء من الثانية؛ أي أننا وصلنا إلى MySQL لكن الاسم غير موجود. هذه حالة مختلفة جذريا عن خادم متوقف.

إضافة المصادقة غير المحمّلة: أعادت محاولة المستخدم التجريبي في بيئتنا الرمز 1524. معناه في MySQL هو ER_PLUGIN_IS_NOT_LOADED؛ أي أن إضافة مطلوبة غير محمّلة. في سياق الاتصال هنا نراجع طريقة المصادقة ونص الرسالة الكامل. هذه النتيجة لا تثبت بمفردها خطأ اسم المستخدم أو كلمة المرور، ولا نستبدلها برمز آخر. اختبار اعتماد خاطئ مثل حالة 1045 اختبار مستقل، وليس نتيجة سجلناها في هذه المحاولة. مرجع أخطاء MySQL الرسمي.

ما الذي لا يصلحه هذا الدليل؟

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

تفاصيل التجربة ونتيجتها

تاريخ التجربة: 18 أغسطس 2026؛ ووردبريس: قاعدة المشروع المحلي؛ PHP: 8.3.33؛ مكان التنفيذ وأدواته: MySQL على 127.0.0.1:3308، مهلة اتصال ثانيتان.

الاتصال الصحيح وجد 12 جدولا. المنفذ 3399 أعاد 2002 بعد نحو ثانيتين، اسم القاعدة الوهمي أعاد 1049، والمستخدم الوهمي أعاد 1524 في إعداد MySQL المحلي.

تحقق إضافي، 19 أغسطس 2026: نفذنا أربع محاولات mysqli مستقلة بمهلة محلية قصيرة وسجلنا رموز الاتصال فقط دون أسرار. هذه نتائج محاولات في المختبر وليست تشخيصًا موحدًا لكل خادم. نتيجة 1524 تعني إضافة مطلوبة غير محمّلة، ولا تثبت بمفردها خطأ الاعتماد؛ تُراجع الرسالة الكاملة.

ملاحظة تحريرية، 17 سبتمبر 2026: صُحح تفسير الرمز 1524 وأزيلت البطاقة المصورة التي وصفته بأنه «مستخدم خاطئ». لم تتغير نتيجة المحاولة التاريخية، وهذا التصحيح ليس تجربة جديدة.

المصدر الرسمي

WordPress: إنشاء قاعدة البيانات ومعرفة اسم المضيف والمستخدم.