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

آیا تا به‌حال هنگام تلاش برای باز کردن سایت وردپرسی‌ات با پیام «Error Establishing a Database Connection» مواجه شده‌ای؟ این خطا ممکن است مثل یک دیوار غیرقابل عبور جلوی سایتت ظاهر شود و باعث شود نه سایت نمایش داده شود و نه بتوانی وارد پیشخوان مدیریت شوی. اما نگران نباش؛ این یکی از رایج‌ترین خطاها در وردپرس است و معمولاً قابل حل است اگر بدانیم دقیقاً باید کجا را بررسی کنیم. 


خطا در اتصال به پایگاه‌داده چیست؟

این خطا زمانی رخ می‌دهد که وردپرس نتواند با پایگاه داده (Database) ارتباط برقرار کند. در وردپرس تمام اطلاعات سایت (مثل پست‌ها، تنظیمات، کاربران و …) در پایگاه داده MySQL ذخیره می‌شود. وقتی وردپرس نتواند این ارتباط را برقرار کند، سایت نمی‌تواند اطلاعات را بارگذاری کند و به بازدیدکننده پیغام خطا نشان می‌دهد. 

می‌توان این خطا را مثل این تصور کرد که سایتت می‌خواهد به یک کتابخانه برود تا یک کتاب (اطلاعات) را بخواند، اما درِ کتابخانه بسته است یا کلید اشتباه است—در این حالت سایت نمی‌تواند اطلاعات را بخواند و کارش متوقف می‌شود.


چرا این خطا رخ می‌دهد؟

علل مختلفی می‌توانند باعث خطای Error Establishing a Database Connection شوند. مهم‌ترین آن‌ها عبارت‌اند از:

۱. اطلاعات دیتابیس اشتباه است

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

۲. پایگاه داده خراب شده است

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

۳. سرور دیتابیس از کار افتاده یا پاسخ نمی‌دهد

اگر سرور MySQL یا MariaDB خاموش یا کند باشد، وردپرس نمی‌تواند درخواست اتصال را پردازش کند. این حالت مخصوصاً در هاست‌های اشتراکی زمانی اتفاق می‌افتد که سرور بار زیادی را تحمل می‌کند. 

۴. فایل‌های وردپرس خراب شده‌اند

اگر فایل‌های اصلی وردپرس خراب شوند (برای مثال بر اثر آپلود ناقص یا مشکل در بروزرسانی)، ممکن است باعث ایجاد اختلال در ارتباط با دیتابیس شوند. 


چگونه این خطا را رفع کنیم؟

۱. بررسی و اصلاح اطلاعات پایگاه داده در wp-config.php

فایل wp-config.php در پوشه اصلی وردپرس قرار دارد. در این فایل بخش زیر را پیدا کن و مطمئن شو اطلاعات دقیقاً صحیح هستند: 

define('DB_NAME', 'نام_پایگاه_داده');
define('DB_USER', 'نام_کاربری_دیتابیس');
define('DB_PASSWORD', 'رمزعبور_دیتابیس');
define('DB_HOST', 'localhost');

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


۲. بررسی سرور دیتابیس

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


۳. تعمیر دیتابیس وردپرس

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

/* That’s all, stop editing! Happy blogging. */

در فایل wp-config.php قرار بده: 

define('WP_ALLOW_REPAIR', true);

بعد از ذخیره، به آدرس زیر برو:

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

در این صفحه می‌توانی دیتابیس را تعمیر و بهینه‌سازی کنی.

پس از پایان، فراموش نکن این خط را از فایل حذف کنی تا امنیت سایت حفظ شود. 


۴. جایگزینی فایل‌های هسته وردپرس

اگر به نظرت فایل‌های وردپرس آسیب دیده‌اند، می‌توانی نسخه جدید وردپرس را از سایت رسمی دانلود کنی و فایل‌های هسته را بدون پوشه wp-content در هاست آپلود و جایگزین کنی. این کار باعث می‌شود فایل‌های خراب دوباره سالم شوند. 


۵. بررسی آدرس سایت (Site URL)

در برخی مواقع که سایت از هاست یا دامنه‌ای به جای دیگر منتقل شده، باید آدرس سایت در دیتابیس به‌روزرسانی شود. این کار را می‌توان از طریق phpMyAdmin و اجرای کوئری SQL انجام داد: 

UPDATE wp_options SET option_value='https://example.com' WHERE option_name='siteurl';

به جای https://example.com آدرس سایت خودت را قرار بده. 


پیشگیری از بروز این خطا در آینده

  • همیشه قبل از انتقال سایت یا تغییر اطلاعات دیتابیس از سایت نسخه پشتیبان بگیر.
  • اطلاعات دیتابیس مثل نام، رمز و نام کاربری را در جایی مطمئن ذخیره کن.
  • هنگام نصب افزونه یا بروزرسانی، از سلامت فایل‌ها مطمئن شو و در صورت بروز خطا از آپدیت ناتمام جلوگیری کن.
  • از هاستی با پشتیبانی مناسب و سرورهای پایدار استفاده کن تا مشکلات سرور باعث بروز خطا نشوند. 

جمع‌بندی

خطای “Error Establishing a Database Connection” زمانی رخ می‌دهد که وردپرس نتواند ارتباط لازم با پایگاه داده را برقرار کند. این مشکل می‌تواند از اشتباه بودن اطلاعات اتصال، خرابی دیتابیس، قطع بودن سرویس پایگاه داده یا فایل‌های آسیب‌دیده ناشی شود. با بررسی دقیق اطلاعات در فایل wp-config.php، تعمیر دیتابیس، چک کردن وضعیت سرور و حتی جایگزینی فایل‌ها می‌توان مشکل را معمولاً به‌راحتی برطرف کرد. 


سوالات متداول (FAQs)

۱. خطای “Error Establishing a Database Connection” چیست؟

خطایی است که نشان می‌دهد وردپرس نتوانسته با پایگاه داده ارتباط برقرار کند و در نتیجه سایت بارگذاری نمی‌شود. 

۲. اولین کاری که برای رفع این خطا باید انجام داد چیست؟

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

۳. آیا این خطا همیشه به خرابی دیتابیس مربوط است؟

خیر؛ ممکن است اطلاعات اشتباه باشند، سرور دیتابیس در دسترس نباشد یا فایل‌های وردپرس خراب شده باشند. 

۴. آیا می‌توان دیتابیس را تعمیر کرد؟

بله؛ وردپرس ابزار تعمیر دیتابیس دارد که می‌توان آن را با افزودن یک خط کد فعال کرد. 

۵. اگر هیچ‌کدام از راه‌ها جواب نداد باید چکار کنم؟

با پشتیبانی هاستینگ تماس بگیر تا وضعیت سرور، خطاهای سیستم و تنظیمات دیتابیس را بررسی کنند. 

fix-database-connection-error-wordpress
fix-database-connection-error-wordpress