راهنمای رفع خطای “ایجاد اتصال به پایگاه داده” در وردپرس (Error Establishing a Database Connection)

آخرین بروزرسانی در تاریخ مارس 14, 2026 توسط PersiaWebAdmin

خطای “ایجاد اتصال به پایگاه داده” (Error Establishing a Database Connection) یکی از رایج‌ترین و در عین حال آزاردهنده‌ترین خطاهایی است که کاربران وردپرس با آن مواجه می‌شوند. این خطا به این معنی است که وردپرس قادر به برقراری ارتباط با پایگاه داده MySQL خود نیست، جایی که تمام محتوا، تنظیمات و داده‌های سایت شما ذخیره می‌شود. این مشکل می‌تواند به طور ناگهانی رخ دهد و دسترسی به کل سایت (هم بخش ظاهری و هم بخش مدیریت) را مسدود کند.

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

دلایل اصلی خطای اتصال به پایگاه داده

1. اطلاعات نادرست پایگاه داده: نام کاربری، رمز عبور، نام پایگاه داده، یا آدرس هاست (Database Host) اشتباه وارد شده باشد.
2. خرابی پایگاه داده: جداول پایگاه داده آسیب دیده یا خراب شده باشند.
3. فشار زیاد بر روی سرور: تعداد بازدیدکنندگان زیاد یا اجرای اسکریپت‌های سنگین باعث از دسترس خارج شدن موقت پایگاه داده شود.
4. مشکلات مربوط به هاستینگ: سرور پایگاه داده در دسترس نباشد، یا سرویس پایگاه داده به دلیل اتمام منابع (مانند فضای دیسک یا محدودیت پردازش) متوقف شده باشد.
5. به‌روزرسانی ناقص: فرآیند به‌روزرسانی وردپرس، قالب یا افزونه‌ها به درستی کامل نشده باشد.
6. خرابی فایل wp-config.php: این فایل حاوی اطلاعات اتصال به پایگاه داده است و هرگونه تغییر نادرست در آن می‌تواند باعث این خطا شود.

پیشنهاد مطالعه : بهترین افزونه‌های امنیت سایت برای وردپرس کدام هستند ؟

راه‌حل‌های گام‌به‌گام برای رفع خطا

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

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

این اولین و محتمل‌ترین دلیل خطا است.

• روش عملی:

1. با استفاده از یک کلاینت FTP (مانند FileZilla) یا مدیر فایل هاست خود به پوشه ریشه (root) نصب وردپرس خود متصل شوید.
2. فایل wp-config.php را پیدا کرده و آن را دانلود یا ویرایش کنید.
3. به دنبال خطوط زیر بگردید:

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

4. دقت کنید که تمام اطلاعات (نام پایگاه داده، نام کاربری، رمز عبور و هاست) دقیقاً مطابق با اطلاعاتی باشد که هنگام راه‌اندازی پایگاه داده در کنترل پنل هاست خود (مانند cPanel، Plesk و …) وارد کرده‌اید.

• نام پایگاه داده (DB_NAME): نام دقیق پایگاه داده‌ای که برای سایت وردپرسی خود ایجاد کرده‌اید.
• نام کاربری (DB_USER): نام کاربری که برای دسترسی به این پایگاه داده ایجاد کرده‌اید.
• رمز عبور (DB_PASSWORD): رمز عبور مربوط به نام کاربری پایگاه داده.
• هاست پایگاه داده (DB_HOST): معمولاً 'localhost' است، اما برخی هاستینگ‌ها آدرس متفاوتی دارند (مانند mysql.yourdomain.com). این اطلاعات را از پشتیبانی هاست خود دریافت کنید.

5. هرگونه اشتباه تایپی، فاصله اضافی، یا علامت نقل قول نامناسب را اصلاح کنید.
6. فایل را ذخیره کرده و آن را دوباره در سرور آپلود کنید.
7. سایت خود را دوباره بارگذاری کنید تا ببینید آیا مشکل حل شده است.

پیشنهاد مطالعه : راهنمای جامع E-E-A-T

گام ۲: بررسی خرابی پایگاه داده و تعمیر آن

ممکن است جداول پایگاه داده وردپرس شما آسیب دیده باشند. وردپرس قابلیتی برای تعمیر پایگاه داده دارد.

• روش عملی:

1. فایل wp-config.php را که در گام ۱ ویرایش کردید، مجدداً باز کنید.
2. خطوط زیر را به انتهای فایل (قبل از خط /* That's all, stop editing! Happy publishing. */) اضافه کنید:

                                    content_copy                    php        define( 'WP_ALLOW_REPAIR', true );

3. فایل را ذخیره کرده و آپلود کنید.
4. سپس در مرورگر خود به آدرس زیر بروید (نام دامنه خود را جایگزین کنید):

http://www.yourdomain.com/wp-admin/maint/repair.php

5. در این صفحه، روی دکمه “Repair Database” کلیک کنید. وردپرس سعی خواهد کرد جداول آسیب‌دیده را تعمیر کند.
6. پس از اتمام فرآیند، حتماً خط define( 'WP_ALLOW_REPAIR', true ); را از فایل wp-config.php حذف کنید تا از دسترسی غیرمجاز به این قابلیت جلوگیری شود.
7. سایت خود را دوباره بارگذاری کنید.

گام ۳: بررسی منابع سرور و فشار پایگاه داده

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

• روش عملی:

1. موقت کردن تمام افزونه‌ها: همانطور که در مقاله قبلی توضیح داده شد، با تغییر نام پوشه wp-content/plugins به plugins_old، تمام افزونه‌ها را غیرفعال کنید. اگر سایت بالا آمد، مشکل از یکی از افزونه‌ها بوده است. افزونه‌ها را یکی‌یکی فعال کنید تا افزونه مشکل‌ساز را پیدا کنید.
2. تغییر موقت به قالب پیش‌فرض: اگر با غیرفعال کردن افزونه‌ها مشکل حل نشد، پوشه قالب فعال خود را تغییر نام دهید تا وردپرس به صورت خودکار به قالب پیش‌فرض سوئیچ کند.
3. بررسی مصرف منابع هاست: وارد کنترل پنل هاست خود شوید و بخش‌هایی مانند “Resource Usage”، “MySQL Usage” یا “Database Connections” را بررسی کنید. ببینید آیا محدودیتی در مصرف منابع (CPU، RAM، اتصالات پایگاه داده) از سوی هاستینگ اعمال شده است یا خیر.
4. تماس با پشتیبانی هاستینگ: اگر مشکوک هستید که مشکل از سمت سرور یا هاستینگ است (مثلاً سرور پایگاه داده در دسترس نیست یا منابع به اتمام رسیده)، حتماً با پشتیبانی هاستینگ خود تماس بگیرید و مشکل را گزارش دهید.

پیشنهاد مطالعه : رفع خطای صفحه سفید مرگ وردپرس (White Screen of Death)

گام ۴: بررسی فایل db-error.php (در صورت وجود)

گاهی اوقات، وردپرس به جای صفحه سفید، یک صفحه خطای سفارشی به نام db-error.php در پوشه wp-content ایجاد می‌کند.

• روش عملی:

1. در پوشه wp-content سایت خود، به دنبال فایلی به نام db-error.php بگردید.
2. اگر این فایل وجود داشت، آن را دانلود کرده و با یک ویرایشگر کد باز کنید.
3. محتوای آن را بررسی کنید. ممکن است حاوی اطلاعاتی در مورد علت خطا باشد.
4. سپس این فایل را حذف کنید تا وردپرس به حالت عادی خود بازگردد و خطای اتصال را نمایش دهد (که در گام‌های قبل به آن پرداختیم).

گام ۵: افزایش محدودیت حافظه PHP (PHP Memory Limit)

کمبود حافظه PHP نیز می‌تواند منجر به بروز خطاهای غیرمنتظره، از جمله خطای اتصال به پایگاه داده شود، به خصوص زمانی که سرور تحت فشار است.

• روش عملی:

1. فایل wp-config.php را ویرایش کنید.
2. خط زیر را به آن اضافه کنید:

                                    content_copy                    php        define( 'WP_MEMORY_LIMIT', '256M' ); // یا 512M بسته به نیاز و امکانات هاست

3. فایل را ذخیره و آپلود کنید و سایت را تست کنید.

گام ۶: بررسی دامنه پایگاه داده هاست (Database Hostname)

همانطور که در گام ۱ اشاره شد، مقدار DB_HOST در فایل wp-config.php بسیار مهم است. در موارد نادر، ممکن است هاستینگ شما آدرس خاصی برای سرور پایگاه داده تعریف کرده باشد که با localhost متفاوت است.

• روش عملی:

1. وارد کنترل پنل هاست خود شوید (cPanel, Plesk, DirectAdmin و …).
2. به بخش مدیریت پایگاه داده MySQL بروید.
3. اطلاعات مربوط به پایگاه داده سایت خود را پیدا کنید. معمولاً نام هاست (Hostname) در کنار نام پایگاه داده یا نام کاربری ذکر شده است.
4. این آدرس را در مقدار DB_HOST در فایل wp-config.php جایگزین کنید.

پیشنهاد مطالعه : آشنایی با مهمترین مشکلات رایج وب‌سایت‌های فروشگاهی

اقدامات پیشگیرانه

• تهیه منظم بک‌آپ: این مهم‌ترین اقدام است. همیشه از فایل‌ها و پایگاه داده سایت خود بک‌آپ‌های منظم و قابل دسترس داشته باشید.
• استفاده از هاستینگ معتبر: انتخاب یک شرکت هاستینگ خوب با پشتیبانی قوی، از بسیاری از مشکلات جلوگیری می‌کند.
• پرهیز از نصب افزونه‌ها و قالب‌های نامعتبر: افزونه‌ها و قالب‌های ناشناس یا با کیفیت پایین، ریسک بروز مشکلات امنیتی و خطاهای سیستمی را افزایش می‌دهند.
• بررسی سلامت پایگاه داده: به صورت دوره‌ای (مثلاً ماهانه) سلامت پایگاه داده خود را با استفاده از افزونه‌هایی مانند WP-Optimize یا ابزارهای موجود در هاست خود چک کنید.
• مدیریت ترافیک: در صورت افزایش ناگهانی ترافیک، از راه‌حل‌های کشینگ (Caching) استفاده کنید تا فشار کمتری به پایگاه داده وارد شود.

نتیجه‌گیری

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

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