WordPress Yardım, Blog

WordPress Beyaz Ekran (White Screen of Death) Sorunu ve Çözüm Yolları

WordPress beyaz ekran (WSOD), siteye veya wp-admin paneline girdiğinde hiçbir hata mesajı göstermeden bembeyaz bir sayfa görmendir. Bu durum çoğu zaman “site tamamen gitti” anlamına gelmez. Genelde sebep; bozuk/uyumsuz eklenti, tema hatası, PHP bellek limiti, fatal error, yanlış bir güncelleme ya da bakım modunda takılma gibi çözülebilir sorunlardır.

Bu rehberde, önce sorunun nereden kaynaklandığını hızlıca anlamanı sağlayacak bir teşhis sıralaması vereceğim. Ardından, en sık işe yarayan çözüm yöntemlerini en az riskli olandan başlayarak adım adım uygulayacağız.

wordpress beyaz ekran sorunu ve çözüm yolları

Ön Teşhis: Beyaz Ekran Nerede Oluyor?

  • Sadece ana sayfa / site önü beyaz, wp-admin açılıyorsa → çoğunlukla tema veya ön yüzle ilgili eklenti
  • Sadece wp-admin beyaz, site önü açılıyorsa → çoğunlukla admin ile ilgili eklenti, editör veya cache/minify
  • Hem site önü hem wp-admin beyaz → çoğunlukla fatal error, PHP bellek, çekirdek dosya sorunu veya bakım modu

Altın kural: İlk hedef “siteyi ayağa kaldırmak”, ikinci hedef “hata kaynağını netleştirmek” olmalı. Bu yüzden adımları sırayla uygula.

1) Bakım Modunda Takılma: .maintenance Dosyasını Kontrol Et

Güncelleme sırasında yarıda kesilme olduysa, kök dizinde .maintenance dosyası kalır ve site boş/beyaz kalabilir.

  1. FTP / Dosya Yöneticisi ile sitenin kök dizinine gir (public_html gibi).
  2. .maintenance dosyasını bul.
  3. Dosyayı sil.
  4. Siteyi ve wp-admin’i yenile.

2) En Yaygın Sebep: Eklentileri Toplu Devre Dışı Bırak

WSOD vakalarının büyük kısmı eklentiden çıkar. Panel açılmıyorsa en hızlı yöntem, eklentileri klasör üzerinden pasife almaktır.

  1. FTP / Dosya Yöneticisi ile wp-content klasörüne gir.
  2. plugins klasörünün adını geçici olarak plugins-old yap.
  3. Siteyi yenile.

Sorun düzeldiyse: Klasör adını tekrar plugins yap, sonra eklentileri tek tek açarak suçluyu bul:

  • Önce “cache/minify”, “security”, “page builder”, “redirect”, “SEO” gibi ağır eklentilerden şüphelen.
  • Son yüklenen/güncellenen eklenti çoğu zaman suçludur.

3) Tema Kaynaklı mı? Varsayılan Tema ile Test Et

Eklentileri kapattın ama hâlâ beyaz ekran varsa sıradaki şüpheli temadır. Tema bozulmuş, güncel WP/PHP ile uyumsuz ya da dosyası eksik olabilir.

Yöntem A: FTP ile aktif temayı devre dışı bırak

  1. wp-content/themes içine gir.
  2. Aktif temanın klasör adını geçici olarak değiştir (ör: tema-adi-old).
  3. WordPress otomatik olarak varsa varsayılan temaya düşer (Twenty Twenty-*).
  4. Siteyi yenile.

Yöntem B: PhpMyAdmin ile template/stylesheet değiştir

  1. PhpMyAdmin → veritabanı → wp_options tablosu.
  2. template ve stylesheet satırlarını bul.
  3. Değerleri örneğin twentytwentytwo veya sunucunda yüklü olan default tema klasör adına çevir.
  4. Kaydet ve siteyi yenile.

Not: Tablolarda wp_ öneki farklı olabilir. (Örn: x7k_options) Bu normaldir.

4) PHP Bellek Limitini Artır (Özellikle Büyük Sitelerde)

Yetersiz bellek limiti “fatal error” üretir ve bazen ekranda hiçbir şey göstermeden beyaz sayfaya düşersin.

  1. wp-config.php dosyasını aç.
  2. <?php satırının hemen altına şunu ekle:
define('WP_MEMORY_LIMIT', '256M');

Hosting izin veriyorsa ek olarak PHP ayarlarından da yükseltmek gerekir. (hPanel/cPanel’de “PHP Options” veya “Select PHP Version” altında.)

5) Gerçek Hata Mesajını Yakala: WP_DEBUG ile Log Al

“Beyaz ekran” aslında çoğu zaman hata mesajının gizlenmiş halidir. Amaç hatayı ekranda göstermek değil, log dosyasına yazdırmak olmalı.

wp-config.php dosyasında şu ayarları ekle (varsa güncelle):

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

Sonra tekrar siteyi açmayı dene ve şu dosyayı kontrol et:

/wp-content/debug.log

Burada genelde hataya sebep olan eklenti/tema dosya yolu açıkça yazar. (Örn: plugins/xxx/xxx.php gibi.)

6) Cache / CDN / Minify Çakışmaları (Görünmez WSOD Sebebi)

Bazen site aslında hatalı değildir; “cache/minify/JS birleştirme” yüzünden özellikle admin ekranı bembeyaz olur. Şunları dene:

  • Cache eklentisi klasörünü geçici pasifle (2. adım gibi).
  • Cloudflare kullanıyorsan: Development Mode aç, cache’i boşalt.
  • Tarayıcıda “hard refresh” yap (Ctrl+F5).

7) Son Çare: WordPress Çekirdek Dosyalarını Temiz Yenile

Güncelleme yarıda kaldıysa veya dosyalar bozulduysa, WordPress çekirdeğini temizlemek işe yarar. Bu adımda wp-content ve wp-config.php dosyana dokunulmaz.

  1. Mevcut dosyaların yedeğini al.
  2. WordPress’in temiz sürümünden wp-admin ve wp-includes klasörlerini yeniden yükle.
  3. Siteyi kontrol et.

Hâlâ Düzelmediyse: Hızlı Kontrol Listesi

  • PHP sürümü yeni mi? (Yeni PHP + eski tema/eklenti çakışır.)
  • Sunucu error log (hosting panelinde) ne diyor?
  • Disk dolu mu? (Bazı hostlarda disk dolunca site bozulur.)
  • Şüpheli bir müdahale oldu mu? (Dosya eklenmesi, yeni admin, bilinmeyen eklenti)

Sonuç: WSOD Çoğu Zaman 10 Dakikada Çözülür

WordPress beyaz ekran hatası can sıkıcıdır ama çoğunlukla eklentiler/tema/bakım modu/bellek çizgisinde çözülen bir problemdir. Bu rehberdeki sıralamayı aynen uygularsan, büyük ihtimalle siteyi hızlıca ayağa kaldırırsın.

İstersen WordPress sorunları için WordPress Yardım kategorisindeki diğer teknik çözümlere de bakabilirsin.

Sorununuz devam ediyor mu?
WSOD’u çözemediysen, iletişim sayfasından “WSOD” diye yazıp hangi hosting panelini kullandığını (cPanel/hPanel/Plesk) belirt. Dosya yapısı + log’a göre en hızlı yolu netleştiririz.