WordPress Beyaz Ekran ve Veritabanı Bağlantı Hatası Çözümü

Kısa cevap: WordPress'te beyaz ekran (WSOD) genellikle PHP bellek limiti, hatalı eklenti/tema ya da PHP hatasından kaynaklanır; çözüm için hata ayıklama modunu (WP_DEBUG) açıp hatayı görmek, eklentileri devre dışı bırakmak ve bellek limitini artırmaktır. "Veritabanı bağlantı hatası" (Error establishing a database connection) ise wp-config.php içindeki veritabanı bilgilerinin yanlış olması, MySQL servisinin çalışmaması ya da veritabanının bozulmasından kaynaklanır.

Bu iki hata WordPress kullanıcılarının en sık karşılaştığı ve en çok panik yaratan durumlardır, çünkü site tamamen erişilemez hale gelir. İyi haber: her ikisinin de sebebi sınırlı sayıda ve sırayla eleyerek çözülebilir. Aşağıda adım adım gidiyoruz.

A. Beyaz ekran (White Screen of Death) çözümü

1. Hata ayıklama modunu açın

Neyin bozulduğunu görmeden tahminle uğraşmayın. wp-config.php dosyasına şu satırları ekleyin:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Bu, hataları wp-content/debug.log dosyasına yazar. Ziyaretçiler hatayı görmez, siz görürsünüz. Sorun çözülünce bu satırları kaldırın.

2. Eklentileri eleyin

Panele giremiyorsanız FTP veya dosya yöneticisiyle wp-content/plugins klasörünün adını plugins-eski olarak değiştirin. Site açılıyorsa sorun bir eklentidedir: klasör adını geri alıp eklentileri tek tek yeniden adlandırarak suçluyu bulun.

3. Temayı test edin

Eklentiler masumsa, aktif temanın klasör adını değiştirin. WordPress varsayılan temaya döner; site açılırsa sorun temadadır.

4. PHP bellek limitini artırın

Bellek yetersizliği beyaz ekranın klasik sebebidir. wp-config.php içine ekleyin:

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

Hosting paketiniz izin vermiyorsa sağlayıcınızdan limit artışı isteyin. Sık sık bu duvara çarpıyorsanız paketiniz projeye küçük geliyor olabilir.

B. "Veritabanı bağlantı hatası" çözümü

1. wp-config.php bilgilerini kontrol edin

En sık sebep budur, özellikle siteyi yeni taşıdıysanız. Şu dört değerin doğru olduğunu teyit edin: DB_NAME, DB_USER, DB_PASSWORD, DB_HOST. Çoğu paylaşımlı hostingde DB_HOST değeri localhost'tur.

2. Veritabanı kullanıcı yetkisini doğrulayın

Kullanıcı doğru olsa bile o veritabanına yetkisi yoksa bağlantı kurulamaz. Kontrol panelinden (cPanel) kullanıcının ilgili veritabanına tüm yetkilerle atanmış olduğunu kontrol edin.

3. MySQL servisi çalışıyor mu?

Kendi sunucunuzu yönetiyorsanız MySQL/MariaDB servisinin ayakta olduğunu kontrol edin. Paylaşımlı hostingde bu sağlayıcı tarafındadır; sunucu yoğunluğu veya kaynak limiti aşımı da bu hataya yol açabilir.

4. Veritabanı onarımı deneyin

Tablolar bozulmuşsa wp-config.php içine şunu ekleyip siteniz.com/wp-admin/maint/repair.php adresini açın:

define('WP_ALLOW_REPAIR', true);

Onarım bitince bu satırı mutlaka kaldırın (güvenlik açığıdır).

Bu hatalar tekrarlıyorsa altyapıya bakın

Beyaz ekran ve veritabanı hatası ara ara tekrarlıyorsa, tek tek düzeltmek yerine kök nedene bakmak gerekir: yetersiz RAM, düşük PHP limitleri, aşırı doldurulmuş paylaşımlı sunucu veya yavaş disk. WordPress için ayrılmış kaynak, NVMe disk ve LiteSpeed önbellek sunan bir ortam bu sorunların çoğunu baştan önler. WordPress hosting paketleri bu iş için optimize edilmiştir; yüksek trafikli siteler için Ryzen VDS daha uygundur.

Projenizin gerçekten ne kadar kaynağa ihtiyacı olduğunu WordPress sunucu gereksinimleri yazımızdan ya da gereksinim hesaplayıcıdan öğrenebilirsiniz.

Sık Sorulan Sorular

WordPress beyaz ekran neden olur?

En sık sebepler: PHP bellek limitinin dolması, hatalı veya çakışan bir eklenti, bozuk tema dosyası ve PHP sürümü uyumsuzluğu. Hata ayıklama modunu açmak gerçek sebebi gösterir.

Panele giremiyorum, eklentiyi nasıl kapatırım?

FTP veya hosting dosya yöneticisiyle wp-content/plugins klasörünün adını değiştirin. WordPress tüm eklentileri devre dışı bırakır ve panele girebilirsiniz.

"Error establishing a database connection" hatası ne demek?

WordPress veritabanına bağlanamıyor demektir. Sebep genelde wp-config.php'deki yanlış bilgiler, kullanıcı yetkisi eksikliği, MySQL servisinin çalışmaması veya bozuk tablolardır.

Site taşıdıktan sonra veritabanı hatası alıyorum, neden?

Yeni sunucudaki veritabanı adı, kullanıcı adı, şifre veya host değeri eski wp-config.php'deki bilgilerle uyuşmuyordur. Yeni bilgileri girerek düzeltebilirsiniz.