WordPress Beyaz Ekran Hatası Nasıl Çözülür? PHP ve Tema Kaynaklı Sorunları Bulma

WordPress beyaz ekran hatası, sitenin ön yüzünde veya yönetim panelinde hiçbir açıklama görünmeden boş bir sayfa oluşmasıdır. Sorun çoğunlukla PHP çalışma hatası, uyumsuz tema veya eklenti, yetersiz bellek ya da başarısız bir güncelleme sonrasında ortaya çıkar. Çözüm için rastgele dosya silmek yerine hatanın nerede başladığını belirlemek gerekir.

WordPress beyaz ekran hatası neden oluşur?

Beyaz ekran, WordPress’in sayfayı tamamlayamadan durduğunu gösterir; ancak tek başına kesin nedeni söylemez. Son değişiklik, hata kapsamı ve sunucu kayıtları birlikte incelenmelidir.

• Tema veya eklenti çakışması: İki bileşenin aynı işlevi farklı biçimde çalıştırması ya da bir eklentinin mevcut PHP sürümüyle uyumsuz olması sayfanın yüklenmesini engelleyebilir.
• PHP bellek sınırı: Büyük görseller, ağır eklentiler veya karmaşık sorgular tanımlanan bellek limitini aşabilir.
• PHP sürümü uyumsuzluğu: Eski bir tema ya da eklenti, sunucudaki yeni PHP sürümünde artık desteklenmeyen işlevler kullanabilir.
• Başarısız güncelleme: Dosyaların eksik yüklenmesi, izin problemi veya yarım kalan otomatik güncelleme beklenmeyen hatalara yol açabilir.

Önce hatanın kapsamını belirleyin

Siteyi gizli sekmede açarak sorunun yalnızca tek bir sayfada mı, tüm ön yüzde mi oluştuğunu kontrol edin. Ardından /wp-admin adresini deneyin. Yönetim paneli açılıyor ancak ana sayfa boş görünüyorsa tema veya ön yüz bileşenleri daha güçlü adaydır. Hem panel hem de ön yüz açılmıyorsa son eklenti, tema, PHP ve bellek değişikliklerine odaklanın.

Hata başlamadan hemen önce ne yaptığınızı not edin. Yeni eklenti kurulumu, tema değişikliği, PHP yükseltmesi veya toplu güncelleme varsa teşhis süresi kısalır. Hosting panelindeki hata kayıtları da hangi dosyanın ve satırın işlemi durdurduğunu gösterebilir.

WordPress hata ayıklama kaydını etkinleştirin

Dosya yöneticisi veya SFTP ile sitenin kök dizinindeki wp-config.php dosyasını yedekleyin. /* That’s all, stop editing! */ satırından önce aşağıdaki ayarları ekleyin:

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

Bu yapılandırma hatayı ziyaretçilere göstermek yerine wp-content/debug.log dosyasına yazdırır. Kaydı yalnızca teşhis sırasında kullanın; işlem tamamlanınca WP_DEBUG değerini tekrar false yapın. Günlükte bir eklenti veya tema klasörü görünüyorsa sonraki adımı buna göre seçin.

Eklenti ve temayı güvenli biçimde test edin

Yönetim paneli açılıyorsa Eklentiler bölümünden tüm eklentileri devre dışı bırakın. Site düzelirse eklentileri tek tek etkinleştirerek sorunlu bileşeni bulun. Panel açılmıyorsa SFTP veya dosya yöneticisinde wp-content/plugins klasörünün adını geçici olarak değiştirin. Bu işlem eklentileri topluca pasifleştirir; teşhis sonrasında klasör adını eski hâline getirebilirsiniz.

Eklentiler devre dışıyken sorun devam ederse etkin temayı test edin. wp-content/themes altında kullanılan temanın klasör adını geçici olarak değiştirerek WordPress’in varsayılan bir temaya geçmesini sağlayabilirsiniz. Tema dosyasındaki özel kodları, özellikle functions.php değişikliklerini de kontrol edin.

Bir güncellemeden sonra sorun başladıysa önce yedek alın ve hangi bileşenin değiştiğini belirleyin. Gerekirse eklenti güncellemesi sonrası oluşan site sorunlarını güvenli biçimde ayırma rehberine bakın; ancak geri dönüşü kalıcı çözüm değil, geçici teşhis adımı olarak değerlendirin.

PHP sürümü ve bellek sınırını kontrol edin

Hosting panelinden etkin PHP sürümünü ve hata kayıtlarını inceleyin. PHP sürümünü doğrudan değiştirmeden önce kullanılan tema ve eklentilerin destek durumunu kontrol edin. Üretim sitesinde denemeyi mümkünse staging ortamında yapın; uyumsuz bir sürümü canlıda test etmek yeni hatalar doğurabilir.

Bellek hatalarında günlükte genellikle “Allowed memory size exhausted” benzeri bir ifade görülür. WordPress’in yönetim belleğini artırmak bazen yardımcı olabilir; fakat bu ayar hosting hesabının gerçek limitini aşamaz. Sürekli artan bellek kullanımı varsa ağır eklentiyi, hatalı sorguyu veya tema kodunu düzeltmek gerekir. Sadece limiti yükseltmek altta yatan problemi gizleyebilir.

Yönetim paneli açılmıyorsa uygulanacak sıra

1. Dosya ve veritabanı yedeğini alın.
2. Hosting hata kayıtlarında son PHP hatasını arayın.
3. Eklentileri klasör adını değiştirerek topluca devre dışı bırakın.
4. Düzelme olmazsa etkin temayı geçici olarak devre dışı bırakın.
5. wp-config.php içindeki hata ayıklama ayarlarını ve bellek yapılandırmasını kontrol edin.
6. PHP sürümünü, hosting sağlayıcısının desteklediği uyumlu bir sürümle karşılaştırın.

Bu işlemlerden sonra site açılırsa bile tüm eklentileri birden geri etkinleştirmeyin. Her değişiklikten sonra ön yüzü ve yönetim panelini ayrı ayrı test edin.

Sorun çözüldükten sonra yapılması gerekenler

Hatalı bileşeni güncelleyin veya geliştiricisinin belirttiği uyumlu sürüme dönün. Kullanılmayan eklentileri kaldırın, PHP hata kayıtlarını tekrar gözden geçirin ve önbellek katmanlarını temizleyin. Sorun sunucu yanıtıyla birlikte 500 hatasına dönüşüyorsa hosting kayıtlarını incelemek gerekir; ağ bağlantısı kaynaklı durumlarda ise Cloudflare 522 hatasının origin sunucu kontrolleri farklı bir teşhis süreci gerektirir.

WordPress’in resmi hata ayıklama yaklaşımı için WordPress geliştirici belgelerindeki hata ayıklama kılavuzunu kullanabilirsiniz. Teşhis tamamlandığında hata gösterimini kapatın, geçici klasör adlarını eski hâline getirin ve sitenin kritik sayfalarını yeniden test edin.

WordPress beyaz ekran hatası hakkında sık sorulanlar