شنبه تا چهارشنبه، ۹ تا ۱۸. پشتیبانی فنی ۲۴ ساعته تا ۷ روز پولتان برمی‌گردد انتقال رایگان سایت، بدون قطعی
تازه‌ترین نوشته‌هابلاگتازه‌ترین نوشته‌ها
وردپرس

رفع خطای «ارتباط با پایگاه داده برقرار نشد» در وردپرس

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

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

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

۱. آیا تازه چیزی را عوض کرده‌اید؟

اول این را بپرسید، چون جواب معمولاً همین است.

  • سایت را تازه منتقل کرده‌اید؟ نام پایگاه داده و کاربر روی هاست جدید فرق می‌کند. برو به قدم ۲.
  • رمز را تازه عوض کرده‌اید؟ رمز کاربر پایگاه داده در cPanel عوض شده ولی در wp-config.php نه. برو به قدم ۲.
  • هیچ چیزی عوض نشده و سایت دیروز کار می‌کرد؟ احتمالاً سرور پایگاه داده مشکل دارد. برو به قدم ۴.

۲. اطلاعات wp-config.php را بررسی کنید

در File Manager به public_html بروید و wp-config.php را با Edit باز کنید. این چهار خط را پیدا کنید:

define( 'DB_NAME', 'myaccount_wpdb' );
define( 'DB_USER', 'myaccount_wpuser' );
define( 'DB_PASSWORD', 'رمز' );
define( 'DB_HOST', 'localhost' );

سه چیز را مقایسه کنید:

نام پایگاه داده — در cPanel به MySQL Databases بروید. نام واقعی با پیشوند حساب شروع می‌شود. اگر در wp-config.php نوشته wpdb ولی نام واقعی myaccount_wpdb است، همین علت است.

نام کاربر — همان قاعده. پیشوند باید باشد.

رمز — اگر مطمئن نیستید، در MySQL Databases روی کاربر کلیک کنید و رمز تازه‌ای بگذارید، بعد همان را در wp-config.php بنویسید. رمز را جایی کپی کنید که فاصلهٔ اضافه نگیرد؛ یک فاصله در ابتدا یا انتهای رمز، همین خطا را می‌دهد و چشم آن را نمی‌بیند.

۳. آیا کاربر به پایگاه داده وصل است؟

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

در MySQL Databases، پایین صفحه بخش Add User To Database. کاربر و پایگاه داده را انتخاب کنید، Add را بزنید، و در صفحهٔ بعد ALL PRIVILEGES را تیک بزنید.

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

۴. آیا خودِ پایگاه داده پاسخ می‌دهد؟

این را با یک فایل کوچک تست کنید. فایلی به نام dbtest.php در public_html بسازید با این محتوا (مقادیر را از wp-config.php بگذارید):

<?php
$c = @mysqli_connect( 'localhost', 'myaccount_wpuser', 'رمز', 'myaccount_wpdb' );
if ( $c ) {
    echo 'اتصال برقرار شد';
} else {
    echo 'خطا: ' . mysqli_connect_error();
}

آدرس example.com/dbtest.php را باز کنید.

  • «اتصال برقرار شد» — یعنی اطلاعات درست است و مشکل جای دیگری است. برو به قدم ۶.
  • Access denied for user — رمز یا نام کاربر غلط است، یا کاربر به پایگاه داده وصل نیست. برگرد به قدم ۲ و ۳.
  • Unknown database — نام پایگاه داده غلط است، یا پایگاه داده پاک شده.
  • Can't connect to MySQL server — سرور پایگاه داده پاسخ نمی‌دهد. این مشکل هاست است، نه شما. برو به قدم ۵.

بعد از تست، dbtest.php را حذف کنید. این فایل رمز پایگاه دادهٔ شما را در خودش دارد و نباید روی سرور بماند.

۵. سرور پایگاه داده پاسخ نمی‌دهد

اگر پیام Can't connect to MySQL server گرفتید، کاری از دست شما برنمی‌آید جز دو چیز:

  • در cPanel بخش Resource Usage را ببینید. اگر حساب به سقف منابعش خورده باشد، اتصال‌های پایگاه داده رد می‌شوند. معمولاً یک افزونه یا رباتی که سایت را می‌خزد علتش است.
  • تیکت به پشتیبانی هاست، با همان پیام خطای دقیق. پیام دقیق، جواب را سریع‌تر می‌آورد.

۶. جدول‌ها خراب شده‌اند

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

این خط را به wp-config.php اضافه کنید، درست بالای خطی که نوشته That's all, stop editing!:

define( 'WP_ALLOW_REPAIR', true );

بعد این آدرس را باز کنید:

example.com/wp-admin/maint/repair.php

گزینهٔ Repair Database را بزنید. اگر جواب نداد، Repair and Optimize را امتحان کنید.

وقتی کار تمام شد، آن خط را از wp-config.php بردارید. تا وقتی آن خط هست، این صفحه بدون ورود به سایت برای همه باز است.

۷. اگر هیچ‌کدام نبود

در این حالت از یک نسخهٔ پشتیبان برگردید. راهنمای بازگردانی در سی‌پنل قدم‌هایش را دارد. اگر پشتیبان ندارید، قبل از هر کار دیگری از وضعیت فعلی پایگاه داده یک نسخه بگیرید — حتی اگر خراب است، خرابِ موجود بهتر از هیچ است.

این نوشته کمکتان کرد؟ نه، هنوز سوال دارم

نوشته‌های مرتبط