WORDPRESS // HATA ÇÖZÜMÜ // BEYAZ EKRAN

WordPress Beyaz Ekran Hatası Nasıl Çözülür? Boş Sayfanın Nedenini Adım Adım Bulun

WordPress beyaz ekran hatası, siteniz ya da yönetim paneli açıldığında hiçbir hata mesajı olmadan bomboş bir sayfa görmenizdir. Ekranda ipucu olmadığı için nedeni tahmin etmek zordur. Bu rehberde gizli kalan hata mesajını görünür hâle getiriyor, ardından eklenti, tema, bellek ve önbellek kaynaklı nedenleri sırayla eliyoruz.

Kısa cevap: Beyaz ekranın arkasında çoğu zaman ekrana yazdırılmayan bir PHP hatası vardır. Hata kaydını açıp debug.log dosyasındaki son satırları okuyun; satırdaki dosya yolu sorunlu eklentiyi ya da temayı gösterir. Kayıt bir şey söylemiyorsa eklentileri, ardından temayı klasör adını değiştirerek devre dışı bırakın.

WordPress beyaz ekran hatası nedir?

Beyaz ekran (White Screen of Death, kısaca WSOD), sunucunun sayfayı üretemediği ama nedenini göstermediği durumdur. PHP ölümcül bir hatayla durur, hata mesajı ekrana yazdırılmaz ve tarayıcıya boş bir yanıt gider. Tarayıcınıza göre bomboş beyaz bir sayfa ya da HTTP ERROR 500 görebilirsiniz.

WordPress 5.2 sürümünden beri ölümcül hataların çoğunu kendisi yakalar ve ekranda “kritik bir hata oluştu” uyarısını gösterir. Bu uyarıyı görüyorsanız kritik hata rehberimizdeki kurtarma modu adımları daha hızlı sonuç verir. Ekranda hiçbir mesaj yoksa hata WordPress yüklenmeden önce (ör. wp-config.php içinde) oluşmuş, WordPress’in hata yakalayıcısı kapatılmış ya da önbellek boş bir kopyayı sunuyor olabilir.

İpucu: Boş sayfadayken Ctrl + U ile sayfa kaynağını açın. Kaynak tamamen boşsa sorun sunucu tarafındadır (PHP). Kaynakta HTML kodu varsa sayfa üretiliyor ama bir stil ya da betik hatası onu görünmez kılıyordur.

Beyaz ekran nerede görülüyor?

Beyaz ekranın göründüğü yer, nedeni büyük ölçüde daraltır. Çözüme geçmeden önce aşağıdaki durumlardan hangisinin size uyduğuna bakın.

Nerede görülüyor?Ne anlama gelir?İlk bakılacak yer
Tüm sitede ve yönetim panelindeHer istekte çalışan bir kod (eklenti, tema, wp-config.php) bozuk.Hata kaydı, ardından eklentiler
Yalnızca ön yüzde, panel açılıyorTema ya da yalnızca ön yüzde çalışan bir eklenti.Etkin tema
Yalnızca yönetim panelinde veya yazı düzenleyicideYönetim tarafında çalışan bir eklenti ya da JavaScript hatası.Tarayıcı konsolu, eklentiler
Yalnızca tek bir sayfadaO sayfaya özgü bir kısa kod, sayfa şablonu ya da bellek sınırı.Hata kaydı
Bir güncellemeden hemen sonraYeni sürüm, PHP sürümüyle ya da başka bir eklentiyle uyumsuz.Son güncellenen eklenti veya tema
Hata giderildi ama sayfa hâlâ boşÖnbellekte kalan eski, boş kopya.Önbellek temizliği

Gizli hata mesajını görünür hâle getirin

Beyaz ekranı çözmenin en kısa yolu, PHP’nin gizlediği hata mesajını okumaktır. Hosting panelinizin dosya yöneticisinden ya da FTP ile sitenin kök dizinindeki wp-config.php dosyasını açın.

Dikkat: wp-config.php dosyasını düzenlemeden ve klasör adlarını değiştirmeden önce sitenizin dosya ve veritabanı yedeğini alın. Bu dosyadaki tek bir yanlış karakter de siteyi beyaz ekrana düşürebilir.

Aşağıdaki satırları require_once ABSPATH . 'wp-settings.php'; satırından önce ekleyin. Dosyada WP_DEBUG zaten tanımlıysa yeni satır eklemek yerine değerini true yapın; aynı sabiti iki kez tanımlamak yeni bir uyarı üretir.

Hata kaydını açma wp-config.php · Geçici kullanım
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Kodu panoya almak için düğmeyi kullanın.

Dosyayı kaydedip beyaz ekran veren sayfayı yeniden açın. Hata wp-content/debug.log dosyasına yazılır; dosyanın en altındaki satırlar en yenileridir. WP_DEBUG_DISPLAY değeri false olduğu için mesaj ziyaretçilere gösterilmez.

debug.log oluşmuyorsa

Hata wp-config.php dosyasının kendisinde ya da WordPress yüklenmeden önce oluşuyorsa WordPress kayıt tutamaz. Bu durumda hosting panelindeki hata günlüğüne bakın: cPanel’de Metrics → Errors, diğer panellerde genellikle “Logs” ya da “Error log” adıyla bulunur. Sitenin kök dizininde error_log adlı bir dosya da oluşmuş olabilir.

Günlükteki satır ne anlatıyor?

Satırdaki dosya yolu en önemli ipucudur: yol wp-content/plugins/eklenti-adi/ ile başlıyorsa sorun o eklentide, wp-content/themes/ ile başlıyorsa temadadır. En sık görülen ifadeler şunlardır:

Günlükteki ifadeAnlamıNe yapılır?
Allowed memory size of … bytes exhaustedPHP’nin bu işlem için ayrılan belleği bitti.Bellek sınırını yükseltin; ayrıntılar WP limit artırma rehberinde.
PHP Parse error: syntax errorBir PHP dosyasında yazım hatası var; çoğunlukla son düzenlenen dosya.Satırda adı geçen dosyadaki son değişikliği geri alın.
Call to undefined functionBir eklenti ya da tema, bulunmayan bir işlevi çağırıyor.Yolda adı geçen eklentiyi ya da temayı devre dışı bırakın.
Cannot redeclareAynı işlev iki kez tanımlanmış; genellikle iki eklenti çakışıyor.Satırda adı geçen iki dosyadan birinin eklentisini kapatın.

Adım adım çözüm

Hata kaydı suçluyu doğrudan gösterdiyse yalnızca o eklentiyi ya da temayı devre dışı bırakmanız yeterlidir. Kayıt yoksa ya da yol net değilse aşağıdaki adımlarla eleme yapın. Site 1. adımdan sonra da açılmıyorsa sorun eklentilerde değildir; klasörün adını geri alıp 4. adıma geçin.

1
Eklentileri toplu kapatın Dosya yöneticisinde ya da FTP’de wp-content/plugins klasörünün adını plugins-kapali yapın ve siteyi yenileyin.
2
Eklentileri devre dışı bıraktırın Site açıldıysa yönetim panelinde Eklentiler → Yüklü eklentiler sayfasını bir kez açın; WordPress bulamadığı eklentileri devre dışı bırakır. Ardından klasörün adını plugins olarak geri alın.
3
Eklentileri tek tek etkinleştirin Her etkinleştirmeden sonra siteyi gizli pencerede açın. Beyaz ekranı geri getiren eklenti sorunun kaynağıdır.
4
Temayı devre dışı bırakın Eklentiler temiz çıktıysa wp-content/themes altındaki etkin temanın klasör adını değiştirin. WordPress yüklü bir varsayılan temaya (Twenty Twenty-Five gibi) geçer.
5
Önbelleği temizleyin Sorunu giderdiğiniz hâlde sayfa boş görünüyorsa önbellek eklentinizin, sunucunun ve varsa Cloudflare’in önbelleğini temizleyin.

WordPress beyaz ekran hatası yalnızca yönetim panelinde görülüyorsa

Ön yüz açılıyor ama panel boş kalıyorsa sorun büyük olasılıkla yalnızca yönetim tarafında çalışan bir eklentidedir; yukarıdaki eklenti adımları burada da geçerlidir. Panel açılıyor ama yazı düzenleyicinin içi beyaz kalıyorsa sorun çoğunlukla PHP değil JavaScript’tir. Tarayıcıda F12 ile geliştirici araçlarını açın ve Console sekmesindeki kırmızı satırlara bakın; satırdaki dosya yolu hatayı veren eklentiyi gösterir.

Beyaz ekran bir güncellemeden sonra başladıysa

İlk şüpheli, son güncellenen eklenti ya da temadır. Onu klasör adını değiştirerek devre dışı bırakın ve geliştiricisinin düzeltme yayımlamasını bekleyin ya da önceki sürümünü yükleyin. PHP sürümünü yeni yükselttiyseniz eski bir eklenti yeni sürümle uyumsuz olabilir; PHP sürümü güncelleme rehberimizdeki uyumluluk adımlarına bakın ya da sürümü geçici olarak bir önceki değere alın.

Sorun çözüldükten sonra yapılacaklar

Site yeniden açıldığında hata ayıklama ayarlarını kapatmayı ve geçici değişiklikleri geri almayı unutmayın.

wp-config.php dosyasında WP_DEBUG değerini yeniden false yaptım.
wp-content/debug.log dosyasını sildim; bu dosya tarayıcıdan açılabilir ve sunucu yolları gibi bilgiler içerir.
Değiştirdiğim klasör adlarını (plugins, tema klasörü) eski hâline getirdim.
Sorunlu eklenti için güncelleme ya da alternatif belirledim.
Siteyi ve yönetim panelini gizli pencerede, oturum açmadan da kontrol ettim.

Sık sorulan sorular

Beyaz ekran içeriğimin silindiği anlamına mı gelir?

Hayır. Yazılarınız, sayfalarınız ve ayarlarınız veritabanında durmaya devam eder; yalnızca sayfa üretilemiyordur. Hatayı giderdiğinizde içerik olduğu gibi geri gelir.

Beyaz ekran SEO sıralamamı etkiler mi?

Birkaç saatlik bir kesinti genellikle kalıcı bir etki bırakmaz. Sorun günlerce sürerse arama motorları sayfalara ulaşamadığı için onları sonuçlardan düşürebilir; bu yüzden hatayı hızlıca çözmek önemlidir.

Hosting firmam beyaz ekranı çözebilir mi?

Sunucu günlüklerine tam erişimi olduğu için nedeni bulmanıza yardımcı olabilir ve sunucu kaynaklı sorunları (PHP ayarları, kaynak sınırları) düzeltebilir. Eklenti ve tema hatalarını ise genellikle site sahibinin çözmesi gerekir.

WordPress beyaz ekran hatasını çözemediniz mi?

Hata kaydını birlikte okuyalım, sorunlu eklentiyi ya da temayı bulup sitenizi veri kaybı olmadan yeniden açalım.

Bize Ulaşın