Error Establishing a Database Connection Hatası Nasıl Çözülür (WordPress)

Son doğrulama: Eylül 2026 · cPanel 136 test hesabında denendi

Error Establishing a Database Connection hatası ne anlama gelir, neden olur?

Ziyaretçiyseniz bu ekranı görmeniz, sitenin o an veritabanına ulaşamadığı ve hiçbir içeriğin yüklenemediği anlamına gelir; bu genelde geçici bir sunucu yoğunluğudur, birkaç dakika sonra sayfayı yeniden yükleyin. Site sahibiyseniz Error Establishing a Database Connection hatası iki ayrı kökten çıkar: wp-config.php içindeki bağlantı bilgileri (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) yanlış ya da eskimiş, ya da bilgiler doğru olduğu hâlde MySQL sunucusu o an istekleri karşılayamıyor.

Paylaşımlı hostingde DB_HOST değeri neredeyse her zaman localhost‘tur; farklı bir sunucu adı yazılmışsa bağlantı hiç kurulmaz. Şifre daha önce cPanel’den değiştirilmiş ama wp-config.php güncellenmemişse de aynı hata çıkar. Kullanıcı veritabanına eklenmiş ama ayrıcalık verilmemişse WordPress veritabanını görür ama tablolara yazamaz; bu da bazen aynı hata mesajıyla sonuçlanır.

Veritabanı Bağlantısı Nasıl Onarılır — Adım Adım

Yöntem 1 — wp-config.php içindeki dört değeri kontrol etme

1. cPanel → Veritabanları → MySQL® Veritabanları sayfasını açıp bu siteye ait veritabanı adını ve kullanıcı adını not edin.
   

   

2. cPanel Dosya Yöneticisi’nde public_html kökündeki wp-config.php dosyasını Kod Düzenleyici ile açın. WordPress’in resmi dokümantasyonuna göre DB_NAME, DB_USER, DB_PASSWORD ve DB_HOST satırlarının bir önceki adımda gördüğünüz değerlerle birebir aynı olduğunu karşılaştırın; paylaşımlı hostingde DB_HOST satırı 'localhost' olmalıdır.

   Beklenen sonuç: dört değer de cPanel’de gördüğünüz veritabanı adı, kullanıcı adı ve sunucu adıyla birebir eşleşir.

3. DB_PASSWORD alanını bir sonraki adımda cPanel’den sıfırlayacağınız yeni şifreyle güncelleyeceğinizi unutmayın; şimdilik yalnızca fazladan boşluk ya da yanlış tırnak gibi yazım hatası olup olmadığını kontrol edin.

Yöntem 2 — Kullanıcı-veritabanı yetkisini ve şifreyi cPanel’den sıfırlama

1. cPanel → Veritabanları → MySQL® Veritabanları sayfasında “Kullanıcıları Veritabanlarına Ekle” bölümünden kullanıcının bu veritabanına Tüm Ayrıcalıklar (All Privileges) ile eklendiğini doğrulayın; eklenmemişse ekleyip Ayrıcalıkları Yap’a tıklayın.
2. Aynı sayfada kullanıcının yanındaki “Değiştir Şifre” bağlantısına tıklayıp yeni bir şifre belirleyin.

   Beklenen sonuç: cPanel şifrenin değiştiğini onaylayan bir mesaj gösterir.

3. wp-config.php dosyasında DB_PASSWORD satırını bu yeni şifreyle güncelleyip kaydedin.

Yöntem 3 — Veritabanı onarımı (WP_ALLOW_REPAIR)

Değerler doğru olduğu hâlde hata sürüyorsa veritabanı tabloları bozulmuş olabilir. WordPress’in resmi dokümantasyonuna görewp-config.php‘ye aşağıdaki satır eklenip /wp-admin/maint/repair.php adresine gidildiğinde tablo onarım aracı açılır.

define( 'WP_ALLOW_REPAIR', true );

Beklenen sonuç: sayfa “Veritabanını Onar” ve “Veritabanını Onar ve Optimize Et” seçenekleriyle gelir; işlem bitince bu satırı wp-config.php‘den mutlaka silin, aksi hâlde araç herkese açık kalır.

Yöntem 4 — Sunucu kaynak sınırı nedeniyle MySQL yanıt vermiyorsa

Değerler doğru ve onarım tamamlandığı hâlde hata aralıklarla tekrar ediyorsa neden genelde MySQL’in kendisi değil, hesabın işlemci ya da eşzamanlı süreç sınırına takılmasıdır; sunucu bu anlarda yeni veritabanı bağlantısı açamaz. İşlemci CPU yükü ve performansı nasıl takip edilir kartındaki adımlarla hesabınızın bu sınıra yaklaşıp yaklaşmadığını görebilirsiniz.

Yöntem 5 — phpMyAdmin’den tabloların yerinde olduğunu doğrulama

1. cPanel → Veritabanları → phpMyAdmin‘i açıp sol menüden sitenize ait veritabanını seçin.
   

   

2. Tablo listesinde wp_options, wp_users gibi çekirdek tabloların göründüğünü kontrol edin.

   Beklenen sonuç: tablolar listede görünür ve satır sayıları 0 değildir; bu, veri kaybı olmadığını, sorunun yalnızca bağlantı bilgisinde olduğunu gösterir.

Doğrulama

Hâlâ çözülmediyse

• Değerler doğru ama hata sürüyor. Veritabanı sunucusu farklı bir makinede olabilir; DB_HOST’ta localhost yerine başka bir sunucu adının gerekip gerekmediğini destek talebiyle teyit edin.
• wp-config.php‘ye ulaşamıyorum, panel de açılmıyor. Dosyaya FTP ile de erişebilirsiniz; cPanel’den yeni bir FTP kullanıcısı tanımlama kartına bakın.
• Site açılıyor ama bazı sayfalar hâlâ beyaz ya da boş geliyor. Bu farklı bir belirtidir; WordPress beyaz sayfa hatası kartına bakın.