“Error Establishing a Database Connection” Hatasının Çözümü

Beyaz ekranda tek satır: "Error establishing a database connection." Site tamamen erişilemez hâldedir. İyi haber şu: nedeni neredeyse her zaman altı maddeden biridir. Sırayla ilerleyin.

1. Bağlantı bilgilerini doğrulayın

En yaygın neden budur; özellikle sitenizi yeni taşıdıysanız. wp-config.php dosyasını açın:

define('DB_NAME', 'kullanici_site_wp');
define('DB_USER', 'kullanici_wpuser');
define('DB_PASSWORD', 'parola');
define('DB_HOST', 'localhost');

• DB_NAME ve DB_USER: cPanel → MySQL Veritabanları ekranındaki adlarla birebir aynı olmalı (hesap ön eki dahil).
• DB_PASSWORD: Emin değilseniz cPanel'den kullanıcıya yeni bir parola atayıp buraya yazın.
• DB_HOST: Paylaşımlı hostingde localhost doğrudur. Bazı yapılandırmalarda 127.0.0.1 gerekir.

2. Kullanıcının veritabanına yetkisi var mı?

Veritabanı ve kullanıcı doğru olabilir ama kullanıcı o veritabanına eklenmemiş olabilir. cPanel → MySQL Veritabanları → Kullanıcıyı Veritabanına Ekle ile kullanıcıyı ekleyip ALL PRIVILEGES verin.

3. Veritabanı sunucusu yanıt vermiyor olabilir

Aynı sunucudaki diğer siteleriniz de aynı anda hata veriyorsa sorun sizin sitenizde değildir. Bu durumda destek talebi açın — MySQL servisinin durumunu biz kontrol ederiz.

4. Veritabanı tabloları bozulmuş olabilir

Panelde "One or more database tables are unavailable" gibi bir uyarı görüyorsanız onarım modunu açın. wp-config.php içine ekleyin:

define('WP_ALLOW_REPAIR', true);

Ardından alanadiniz.com/wp-admin/maint/repair.php adresine gidin ve Repair Database deyin. İşlem bitince eklediğiniz satırı mutlaka silin; bu adres oturum açmadan erişilebilir durumdadır.

Onarımdan önce phpMyAdmin üzerinden veritabanının yedeğini alın. Onarım işlemi bozuk kayıtları temizlerken veri kaybı yaşanabilir.

5. Kaynak limitine takılmış olabilirsiniz

Ani trafik artışı veya kötü yazılmış bir eklenti eş zamanlı bağlantı sınırını doldurabilir. Belirtisi: hata aralıklı gelir, sayfa yenileyince bazen açılır.

• cPanel → Kaynak Kullanımı ekranından son 24 saatte limite takılıp takılmadığınıza bakın.
• Son kurduğunuz eklentiyi devre dışı bırakın.
• Sorun sürüyorsa kaynakları ayrılmış bir cloud sunucuya geçmeyi değerlendirin.

6. Disk kotası dolmuş olabilir

Disk dolduğunda MySQL geçici dosya yazamaz ve bağlantı kurulamaz. cPanel ana ekranında disk kullanımınıza bakın; %100'e yakınsa önce yer açın. Nasıl yer açacağınızı disk ve trafik yazımızda anlattık.

Hızlı teşhis: sorun gerçekten veritabanı mı?

public_html içine dbtest.php adında bir dosya oluşturun:

<?php
$c = new mysqli('localhost', 'DB_USER', 'DB_PASSWORD', 'DB_NAME');
if ($c->connect_error) { die('Baglanti hatasi: ' . $c->connect_error); }
echo 'Baglanti basarili';

Tarayıcıdan çağırın. "Baglanti basarili" görüyorsanız sorun kimlik bilgilerinde değil, WordPress dosyalarındadır. Testten sonra dosyayı silin.

Önlem

• Taşıma sonrası wp-config.php bilgilerini ilk iş olarak güncelleyin.
• Veritabanı parolasını değiştirdiğinizde wp-config.php'yi de güncelleyin.
• Düzenli yedek alın; en hızlı çözüm çoğu zaman temiz yedeğe dönmektir.