WordPress beyaz ekran hatası çözümü ararken karşınıza yalnızca boş bir sayfa çıkıyorsa panik yapmayın. Bu sorun çoğunlukla PHP hatası, bellek sınırı, uyumsuz eklenti veya tema kaynaklıdır. Doğru sırayla ilerlediğinizde hem siteyi yeniden açabilir hem de asıl nedeni bulabilirsiniz.
İlk kural basit: Rastgele dosya silmeyin ve birden fazla ayarı aynı anda değiştirmeyin. Mümkünse hosting panelinden dosya ve veritabanı yedeği alın. Her adımın ardından siteyi gizli sekmede kontrol edin; böylece hangi işlemin sorunu düzelttiğini net biçimde görürsünüz.
WordPress beyaz ekran hatası neden olur?
Beyaz ekran, WordPress’in çalışmayı durdurduğu hâlde ziyaretçiye ayrıntılı hata göstermediği durumdur. Bazen tüm site, bazen yalnızca yönetim paneli veya tek bir sayfa etkilenir. En sık karşılaşılan nedenler şunlardır:
- Güncelleme sonrası uyumsuz kalan eklenti veya tema
- PHP bellek sınırının tükenmesi
functions.phpdosyasına eklenen hatalı snippet- Desteklenmeyen PHP sürümü
- Eksik ya da bozulmuş WordPress çekirdek dosyaları
- Sunucu önbelleği, CDN veya güvenlik kuralı çakışması
Tarayıcıdaki boş sayfa tek başına nedeni söylemez. Bu yüzden aşağıdaki kontrolleri kolay ve geri alınabilir olandan başlayarak uygulamak daha güvenlidir.
WordPress beyaz ekran hatası çözümü için 10 adım
1. Hem siteyi hem yönetim panelini kontrol edin
Ana sayfayı, bir yazıyı ve /wp-admin/ adresini ayrı ayrı açın. Yalnızca tek sayfa beyazsa sorun o sayfanın şablonu veya içeriğiyle ilişkili olabilir. Yönetim paneli çalışıyor fakat ön yüz açılmıyorsa aktif tema daha güçlü bir şüphelidir.
2. Önbelleği temizleyin
Tarayıcı, WordPress önbellek eklentisi, hosting önbelleği ve CDN kullanıyorsanız bunları sırayla temizleyin. Cloudflare benzeri bir servis kullanıyorsanız kısa süreli geliştirme modu ile kontrol edin. Yalnızca önbelleği temizlemek kök nedeni çözmeyebilir; fakat eski hata çıktısını görmenizi engeller.
3. Eklentileri topluca devre dışı bırakın
Yönetim paneline erişebiliyorsanız eklentileri geçici olarak kapatın. Panel açılmıyorsa FTP veya hosting dosya yöneticisinden wp-content/plugins klasörünün adını plugins-pasif olarak değiştirin. Site açılırsa klasörü eski adına döndürün ve eklentileri tek tek etkinleştirerek sorunlu olanı bulun.
Bu işlem eklenti dosyalarını silmez. Yine de canlı mağazada ödeme, kargo ve üyelik akışını işlem sonrasında test etmek gerekir. Özellikle WooCommerce sitelerinde yalnızca ana sayfanın açılmasına bakmak yeterli değildir.
4. Varsayılan temaya geçin
Eklentiler kapalıyken hata sürüyorsa aktif temayı test edin. Yönetim panelinden güncel bir varsayılan WordPress temasına geçebilirsiniz. Panele erişemiyorsanız aktif tema klasörünün adını geçici olarak değiştirin; ancak sunucuda kullanılabilir bir varsayılan tema bulunduğundan emin olun.
Tema değişince site açılıyorsa son eklenen PHP kodlarını, tema güncellemesini ve şablon özelleştirmelerini inceleyin. Özel kodlarınızı ana tema yerine bir çocuk temada tutmak geri dönüşü kolaylaştırır. Bunun için WordPress child theme oluşturma rehberini kullanabilirsiniz.
5. WordPress hata günlüğünü açın
Boş ekranın arkasındaki gerçek PHP mesajını görmek için hata kaydını geçici olarak etkinleştirin. Aşağıdaki satırları wp-config.php dosyasında “Hepsi bu, düzenlemeyi bırakın” satırından önce kullanın. Canlı sitede hataları ziyaretçiye göstermemek için WP_DEBUG_DISPLAY değeri kapalı kalmalıdır.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Sayfayı yeniden açtıktan sonra wp-content/debug.log dosyasını kontrol edin. “Fatal error”, “Allowed memory size exhausted” veya belirli bir eklenti yolu gibi ifadeler teşhisi kolaylaştırır. Test bittiğinde WP_DEBUG değerini yeniden false yapın ve log içinde hassas bilgi kalmadığını kontrol edin.
6. PHP bellek sınırını kontrol edin
Log dosyasında “Allowed memory size exhausted” görüyorsanız kaynak tüketen işlemi bulmak gerekir. Geçici test için hosting panelindeki PHP bellek sınırını artırabilirsiniz. Sınırı yükseltmek hatalı eklentiyi iyileştirmez; yalnızca teşhis için zaman kazandırır. Eklenti kapatıldığında bellek kullanımı normale dönüyorsa kalıcı çözüm o eklentiyi güncellemek, değiştirmek veya yapılandırmasını hafifletmektir.
7. PHP sürüm uyumluluğunu inceleyin
Hosting panelinde PHP sürümünün WordPress, tema ve kritik eklentilerinizle uyumlu olduğundan emin olun. Sürümü değiştirmeden önce yedek alın. Yeni sürüme geçince hata başladıysa geçici olarak önceki çalışan sürüme dönüp eklenti ve tema güncellemelerini tamamlayın. Ardından staging ortamında yeniden test edin.
8. Son kod değişikliğini geri alın
Beyaz ekran bir snippet ekledikten hemen sonra oluştuysa en güçlü aday son değişikliktir. Özellikle eksik noktalı virgül, kapanmayan parantez veya aynı fonksiyon adının iki kez tanımlanması PHP’yi durdurabilir. Kodu kaldırıp siteyi kontrol edin. Özel kodları canlı sitede doğrudan düzenlemek yerine geri alma özelliği bulunan snippet eklentisinde ya da çocuk temada denemek daha güvenlidir.
9. WordPress çekirdek dosyalarını yenileyin
Eklenti ve tema testi sonuç vermediyse bozuk çekirdek dosyaları ihtimalini değerlendirin. Önce tam yedek alın. WordPress’in resmi paketinden wp-admin ve wp-includes klasörlerini yenileyebilirsiniz; wp-content klasörüne ve wp-config.php dosyasına dokunmayın. Emin değilseniz bu adımı hosting desteğiyle uygulayın.
10. Sunucu loglarını ve kaynak kullanımını kontrol edin
PHP error log, web sunucusu logu, disk doluluk oranı, inode sınırı ve CPU/RAM kullanımını inceleyin. Disk dolduğunda WordPress önbellek veya oturum dosyası yazamayabilir. Sunucu tarafındaki güvenlik modülü de geçerli bir isteği engelleyebilir. Hosting desteğine yalnızca “site açılmıyor” demek yerine hatanın saati, etkilenen URL ve debug logdaki ilgili satırla başvurmak süreci hızlandırır.
WooCommerce sitesinde ek kontroller
Site yeniden açıldığında mağazanın gerçekten çalıştığını küçük bir test siparişiyle doğrulayın. Ürün sayfası, sepet, ödeme, e-posta ve sipariş yönetimi adımlarını kontrol edin. Vergi ve fatura alanlarını kullanıyorsanız WooCommerce Bireysel Kurumsal Fatura eklentisi ayarlarının güncelleme sonrasında korunduğunu da test edin.
Yoğun sahte üyelik ve form trafiği sunucu kaynaklarını gereksiz yere tüketebilir. Böyle bir durum görüyorsanız logları inceledikten sonra Bolcal Anti Spam gibi hafif bir korumayı değerlendirebilirsiniz. Güvenlik eklentisini kurmak mevcut beyaz ekranı tek başına çözmez; amaç benzer yükleri azaltmaktır.
Hangi durumda profesyonel destek almalısınız?
Yedek yoksa, veritabanı hatası görüyorsanız veya ödeme alan canlı bir mağaza etkileniyorsa deneme yanılmayı uzatmayın. Ayrıca hata sürekli geri dönüyorsa kaynak tüketimi ve kod çakışması birlikte incelenmelidir. İletişim sayfasından destek isteyebilir ya da siteyi yenileme ihtiyacınız varsa web tasarım paketlerini inceleyebilirsiniz.
Site açıldıktan sonra son kontrol listesi
- Değiştirdiğiniz klasör adlarını eski hâline getirin.
- Gereksiz debug modunu kapatın.
- Önbelleği temizleyip mobil ve masaüstünde kontrol edin.
- Form, üyelik, sepet ve ödeme akışını test edin.
- Çalışan sürümün yeni bir yedeğini alın.
- Yaptığınız değişikliği ve hata nedenini kısa bir bakım notuna yazın.
WordPress beyaz ekran hatası çözümü, tek bir sihirli ayardan çok düzenli teşhis gerektirir. Önbellekten başlayıp eklenti, tema, debug log, PHP ve sunucu kontrollerine doğru ilerlerseniz riski düşük tutarsınız. Daha fazla bakım ve e-ticaret rehberi için blog sayfasındaki güncel içeriklere göz atabilirsiniz.