همه مقالات تخصصی

رفع خطای Error Establishing a Database Connection در وردپرس

عیب‌یابی مرحله‌ای خطای اتصال دیتابیس وردپرس؛ از wp-config.php و MySQL تا max_connections، خرابی جدول‌ها و خطاهای موقت زیر بار.

رفع خطای Error Establishing a Database Connection در وردپرس

خطای Error Establishing a Database Connection یعنی PHP نتوانسته به دیتابیس وردپرس وصل شود یا پاسخ معتبر بگیرد. تغییر تصادفی فایل‌ها معمولاً زمان را تلف می‌کند. ابتدا مشخص کنید خطا دائمی است یا فقط زیر بار رخ می‌دهد، سپس مسیر اتصال را از تنظیمات تا سرویس MySQL بررسی کنید.

سلامت سرویس و دسترسی شبکه را بررسی کنید

روی همان سروری که PHP اجرا می‌شود وضعیت 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 باید دقیق باشند. با همان مقادیر از خط فرمان اتصال را امتحان کنید. رمز را در command history ننویسید؛ اجازه دهید client آن را تعاملی بپرسد.

mysql -u DB_USER -p -h DB_HOST DB_NAME

خطاهای مقطعی را به max_connections و منابع ربط دهید

اگر سایت گاهی باز می‌شود، احتمالاً credential ثابت مشکل ندارد. تعداد connectionها، slow query، memory pressure و restart شدن MySQL را بررسی کنید. افزایش کورکورانه max_connections می‌تواند مصرف RAM را بدتر کند؛ ابتدا connection leak و queryهای کند را پیدا کنید.

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

Repair را فقط وقتی شواهد خرابی جدول وجود دارد اجرا کنید

اگر log خطای table corruption می‌دهد، ابتدا backup بگیرید. قابلیت repair وردپرس بدون login قابل دسترسی است؛ اگر موقتاً WP_ALLOW_REPAIR را فعال کردید، بلافاصله بعد از پایان آن را حذف کنید. برای InnoDB، crash recovery و فضای دیسک اغلب مهم‌تر از repair سنتی هستند.

بعد از بازیابی، علت ریشه‌ای را ببندید

فضای دیسک، OOM، timeout شبکه، pool اتصال و تغییرات اخیر را مرور کنید. یک health check ساده برای MySQL و زمان پاسخ دیتابیس اضافه کنید تا مشکل قبل از نمایش خطا به کاربر دیده شود.

چک‌لیست امن

  • قبل از تغییر، از دیتابیس و wp-config.php نسخه پشتیبان بگیرید.
  • وضعیت سرویس و log را ثبت کنید.
  • اتصال را با همان host و user آزمایش کنید.
  • خطاهای مقطعی را با connection و memory مقایسه کنید.
  • گزینه repair را پس از استفاده حذف کنید.

سؤال‌های رایج

آیا این خطا همیشه از رمز اشتباه است؟

خیر. توقف MySQL، پرشدن دیسک، max_connections، DNS، firewall و خرابی جدول نیز می‌توانند همان پیام را ایجاد کنند.

آیا restart دیتابیس کافی است؟

ممکن است سرویس را موقتاً برگرداند، اما بدون بررسی log و منابع احتمال تکرار زیاد است.

آیا باید wp-config.php را منتشر کنم؟

خیر. این فایل شامل اطلاعات حساس است. فقط نام ثابت‌ها و خطای دقیق را به اشتراک بگذارید، نه مقادیر رمز.

راهنماهای مرتبط

برای repair دیتابیس، راهنمای رسمی WordPress تأکید می‌کند دسترسی موقت را پس از پایان غیرفعال کنید.