خطای اتصال به پایگاه داده در وردپرس و نحوه رفع آن

خطای اتصال به پایگاه داده در وردپرس: علت، زمان رخ دادن و راه‌حل عملی

یکی از رایج‌ترین خطاهای وردپرس، خطای اتصال به پایگاه داده است که هنگام باز کردن سایت یا پیشخوان وردپرس رخ می‌دهد و معمولاً پیغام زیر نمایش داده می‌شود:

Error establishing a database connection

این خطا به معنای آن است که وردپرس نمی‌تواند با دیتابیس ارتباط برقرار کند. اگر این مشکل رفع نشود، سایت کاملاً غیرقابل دسترس می‌شود.

در این مقاله، شما با دلایل دقیق بروز خطا و روش‌های عملی و مرحله به مرحله رفع آن آشنا می‌شوید.

زمان رخ دادن

  • هنگام باز کردن کل سایت یا پیشخوان وردپرس
  • بعد از تغییر اطلاعات دیتابیس یا انتقال سایت به سرور جدید
  • بعد از بروزرسانی PHP یا MySQL
  • گاهی به دلیل خرابی جداول دیتابیس یا مشکل در سرویس MySQL

دلایل و علت دقیق بروز

  1. اطلاعات نادرست دیتابیس در wp-config.php : نام پایگاه داده، نام کاربری، رمز عبور یا آدرس سرور اشتباه است.
  2. سرور دیتابیس در دسترس نیست : سرویس MySQL یا MariaDB خاموش یا مشکل دارد.
  3. خرابی یا کرپت شدن جدول‌های دیتابیس : جدول‌ها آسیب دیده و وردپرس نمی‌تواند داده‌ها را بارگذاری کند.
  4. محدودیت منابع هاست : مصرف زیاد RAM یا CPU در هاست اشتراکی باعث عدم پاسخ به وردپرس می‌شود.
  5. ناسازگاری نسخه PHP یا MySQL با وردپرس : بعضی نسخه‌های جدید PHP یا MySQL ممکن است با افزونه یا قالب قدیمی سازگار نباشند

روش رفع مشکل (مرحله به مرحله)

مرحله ۱: بررسی اطلاعات دیتابیس

فایل wp-config.php را باز کنید.
مقادیر زیر را بررسی کنید:

define('DB_NAME', 'database_name_here');
define('DB_USER', 'username_here');
define('DB_PASSWORD', 'password_here');
define('DB_HOST', 'localhost');

اگر هاست شما از سرور دیتابیس جدا استفاده می‌کند، مقدار DB_HOST را مطابق مستندات هاست وارد کنید.

مرحله ۲: بررسی سرویس دیتابیس

در هاست اشتراکی: از پنل مدیریت (cPanel یا Plesk) وضعیت MySQL را بررسی کنید.
در سرور اختصاصی یا VPS:

systemctl status mysql
systemctl restart mysql

اگر سرویس MySQL متوقف است، راه‌اندازی مجدد کنید.

مرحله ۳: تست اتصال دستی به دیتابیس

از طریق ترمینال یا SSH:

mysql -u username_here -p -h localhost database_name_here

اگر اتصال برقرار نشد، مشکل از نام کاربری، رمز عبور یا دسترسی‌هاست.

مرحله ۴: تعمیر پایگاه داده

در wp-config.php اضافه کنید:

define('WP_ALLOW_REPAIR', true);

آدرس زیر را در مرورگر باز کنید:

http://yourwebsite.com/wp-admin/maint/repair.php

گزینه Repair Database یا Repair and Optimize را انتخاب کنید.
بعد از اتمام، خط بالا را از wp-config.php حذف کنید.

مرحله ۵: بررسی منابع هاست و محدودیت‌ها

مصرف منابع RAM و CPU را در هاست بررسی کنید.
در صورت نیاز، با پشتیبانی هاست تماس بگیرید یا از هاست با منابع بیشتر استفاده کنید.

مرحله ۶: بروزرسانی نسخه PHP و MySQL

مطمئن شوید نسخه PHP و MySQL با نسخه وردپرس و افزونه‌ها سازگار است:PHP: 7.4+
MySQL: 5.7+ یا MariaDB 10+

نکات حرفه‌ای

  • اکثر سایت‌ها با اصلاح اطلاعات wp-config.php یا تعمیر دیتابیس مشکل را حل می‌کنند.
  • قبل از هر تغییر، بکاپ کامل دیتابیس و فایل‌ها را تهیه کنید.
  • فعال کردن WP_DEBUG و بررسی لاگ‌ها به شناسایی دقیق مشکل کمک می‌کند.

برای مشاهده همه خطاهای پرتکرار وردپرس و دسترسی به سایر مقالات اختصاصی، مقاله مرجع را ببینید: مرجع خطاهای رایج وردپرس

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

نوزده − 4 =