WordPress’in çalışması için veritabanı bağlantısının sorunsuz olması gerekir. “Error establishing a database connection” uyarısı, WordPress’in MySQL veritabanına bağlanamadığını gösteren ciddi bir sistem hatasıdır. Bu hata çıktığında sitenin tamamı yüklenemez, yönetim paneline giriş yapılamaz ve kullanıcılar boş bir sayfa veya standart WordPress hata ekranı ile karşılaşır.

Bu problem birçok nedenle ortaya çıkabilir; yanlış veritabanı bilgileri, bozulmuş veritabanı tabloları, sunucu sorunları, aşırı trafik, bozuk eklentiler veya yanlış yapılandırılmış PHP hizmeti bu hatanın yaygın sebeplerindendir. Doğru adımlarla incelendiğinde çözümü oldukça nettir.

Error establishing a database connection Hatası Neden Oluşur?

WordPress veritabanıyla sürekli iletişim halindedir. Bağlantı koparsa sistem tamamen durur. Bu hatanın en yaygın nedenleri şunlardır:

Yanlış veritabanı bilgileri: wp-config.php içinde yer alan veritabanı adı, kullanıcı adı, parola ve sunucu adresi doğru değilse bağlantı kurulamaz.

Veritabanı sunucusunun yanıt vermemesi: MySQL servisinin durması, hosting kaynaklarının dolması veya yoğun trafik sonrası sunucuya bağlanılamaması bu hatayı tetikler.

Bozuk veritabanı tabloları: Özellikle ani kapanmalar, yarım kalan işlemler veya hatalı eklenti sorguları veritabanının bozulmasına neden olabilir.

wp-config.php dosyasının zarar görmesi: Yanlış düzenlenmiş, eksik veya bozulmuş yapılandırma dosyası bağlantıyı engeller.

Trafik yoğunluğu: Sunucunun aynı anda çok fazla istek alması MySQL bağlantı limitlerini aşabilir.

Yanlış dosya izinleri: Sunucunun veritabanına bağlanması için gerekli izinler engellenmiş olabilir.

Hosting kaynaklarının tükenmesi: Disk, CPU veya RAM sınırları aşılmışsa veritabanı bağlantısı kesilir.

WordPress “Database Connection” Hatasını Çözme Yöntemleri

Bu hata temelden ilerleyen adımlarla kolayca çözülebilir. Aşağıdaki yöntemler en çok sonuç veren çözümlerdir.

1. wp-config.php Dosyasındaki Veritabanı Bilgilerini Kontrol Etme

WordPress’in çalışması için wp-config.php içinde yer alan bilgiler eksiksiz olmalıdır.

Bu bilgiler şunlardır:

define('DB_NAME', 'veritabani_adi');
define('DB_USER', 'kullanici_adi');
define('DB_PASSWORD', 'parola');
define('DB_HOST', 'localhost');

Bu değerlerdeki küçük bir hata bile bağlantıyı tamamen keser. Özellikle parola veya DB_HOST değeri sıkça karıştırılır.

2. Veritabanını Onarma

Veritabanı bozulduysa WordPress kendi dahili onarım moduyla bunu düzeltebilir. Bunun için wp-config.php dosyasına şu satır eklenir:

define('WP_ALLOW_REPAIR', true);

Ardından WordPress’in onarım ekranı devreye girer. İşlem tamamlandıktan sonra bu satır güvenlik için kaldırılmalıdır.

3. MySQL Sunucusunun Çalışıp Çalışmadığını Kontrol Etme

Bazı durumlarda MySQL servisi durur veya geçici olarak yanıt vermez. Bu durum genellikle yoğun trafik veya hostingte yaşanan servis hatalarından kaynaklanır. Bu tür sorunlarda birkaç dakika bekleyerek yeniden denemek veya hosting panelinden servis durumu kontrol etmek işe yarayabilir.

4. PHP Bellek Limitini Artırma

Yetersiz PHP bellek limiti bazı MySQL işlemlerinin çalışmasını engeller. wp-config.php içine şu satır eklenebilir:

define('WP_MEMORY_LIMIT', '256M');

Daha yüksek limit gerektiren sitelerde bu değer artırılabilir.

5. Eklenti veya Tema Kaynaklı Sorunları Kontrol Etme

Aşırı sorgu oluşturan veya uyumsuz çalışan bir eklenti veritabanını aşırı yükleyip çökmesine neden olabilir.

Kontrol için:

Eklentiler klasörünün adı geçici olarak değiştirilebilir
Tema klasörünün adı geçici olarak değiştirilebilir
Varsayılan WordPress teması devreye alınabilir

Site açılıyorsa problem bir eklenti veya temadan kaynaklanıyordur.

6. wp-config.php Dosyasını Yeniden Oluşturma

Dosya bozulmuşsa WordPress yeni bir wp-config.php oluşturularak hatanın çözülmesi mümkündür. Eski dosya yedeklenip yenisi düzenlenebilir.

7. Veritabanı Kullanıcısına Yetki Verme

Bazen hosting panelinde veritabanı kullanıcısının yetkileri bozulabilir. Kullanıcıya tam yetki verilmesi bu sorunu çözebilir.

Örneğin:

Veritabanı → Kullanıcı Ekle → Tüm ayrıcalıkları ver
şeklinde işlem yapılabilir.

8. Maksimum MySQL Bağlantı Limitinin Aşılması

Yoğun trafik alan sitelerde MySQL bağlantı sayısı dolabilir. Bu durumda:

Trafik anlık olarak azalınca hata ortadan kalkabilir
MySQL bağlantı limitleri hosting tarafından artırılabilir
Önbellekleme eklentisi kullanılarak MySQL yükü azaltılabilir

Hatanın Yeniden Oluşmasını Önlemek İçin Öneriler

Bu hatanın tekrar yaşanmaması için aşağıdaki adımlar uygulanabilir:

Veritabanı düzenli olarak optimize edilmelidir
Uyumsuz eklentiler kullanılmamalıdır
Trafik yoğunluğu için caching sistemi kurulmalıdır
Hosting kaynakları yeterli olmalıdır
wp-config.php düzenlenirken dikkatli olunmalıdır
Veritabanı yedeği otomatik olarak alınmalıdır