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.
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.
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 panelinde | Her istekte çalışan bir kod (eklenti, tema, wp-config.php) bozuk. | Hata kaydı, ardından eklentiler |
| Yalnızca ön yüzde, panel açılıyor | Tema ya da yalnızca ön yüzde çalışan bir eklenti. | Etkin tema |
| Yalnızca yönetim panelinde veya yazı düzenleyicide | Yönetim tarafında çalışan bir eklenti ya da JavaScript hatası. | Tarayıcı konsolu, eklentiler |
| Yalnızca tek bir sayfada | O sayfaya özgü bir kısa kod, sayfa şablonu ya da bellek sınırı. | Hata kaydı |
| Bir güncellemeden hemen sonra | Yeni 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.
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.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
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 ifade | Anlamı | Ne yapılır? |
|---|---|---|
Allowed memory size of … bytes exhausted | PHP’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 error | Bir 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 function | Bir 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 redeclare | Aynı 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.
wp-content/plugins klasörünün adını plugins-kapali yapın ve siteyi yenileyin.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.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.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.plugins, tema klasörü) eski hâline getirdim.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