WordPress Beyaz Ekran Hatası Çözümü

WordPress beyaz ekran hatası çözümü, site sahiplerinin en çok korktukları ve acilen çözüm aramaları gereken teknik sorunlardan biridir. Bir anda sitenizi açtığınızda karşınıza tamamen beyaz bir ekran çıkar; hiçbir hata mesajı, hiçbir içerik, sadece boş beyaz bir sayfa. Bu duruma “White Screen of Death” (WSOD – Beyaz Ölüm Ekranı) da denir ve ilk başta panik yaratıcı görünse de çoğu durumda çözümü oldukça basittir. Beyaz ekran hatası, WordPress kullanıcılarının yaklaşık %15’inin karşılaştığı yaygın bir problemdir ve genellikle eklenti çakışması, tema sorunu, sunucu hafıza yetersizliği veya kod hatalarından kaynaklanır.

Bu hatanın en sinir bozucu yanı, genellikle hiçbir hata mesajı göstermemesidir. Normal şartlarda bir sorun olduğunda WordPress size “Bu sayfada kritik bir hata var” veya benzeri bir uyarı gösterir. Beyaz ekranda ise hiçbir ipucu yoktur; sayfa yüklenir ama tamamen boştur. Bazen sadece ana sayfa beyaz ekran gösterirken yönetim paneli çalışabilir, bazen tam tersi olabilir, bazen de sitenin tamamı etkilenebilir. İyi haber şu ki, beyaz ekran hatası nadiren kalıcı bir hasara işaret eder ve doğru adımları izleyerek sitenizi kısa sürede kurtarabilirsiniz.

Beyaz ekran hatası genellikle şu durumlarda ortaya çıkar: yeni bir eklenti veya tema kurduğunuzda, WordPress’i güncellediğinizde, sitenize kod eklediğinizde veya hosting’inizde bir değişiklik yaptığınızda. Bazen de hiçbir şey yapmadığınız halde, hosting firmanızın yaptığı bir sunucu güncellemesi veya ani trafik artışı nedeniyle oluşabilir. Bu rehberde, beyaz ekran hatasının nedenlerini, adım adım çözüm yöntemlerini ve gelecekte bu sorunla karşılaşmamak için alınması gereken önlemleri anlatacağız.

Beyaz Ekran Hatasının Nedenleri

Eklenti çakışması, beyaz ekran hatasının en yaygın nedenidir. Yeni bir eklenti yüklediğinizde veya mevcut bir eklentiyi güncelledikten sonra bu sorunla karşılaşıyorsanız, büyük ihtimalle o eklenti sorumludur. Bazı eklentiler birbirleriyle uyumsuz çalışabilir, aynı kod fonksiyonlarını kullanmaya çalışabilir veya WordPress’in temel dosyalarıyla çakışabilir. Örneğin, iki farklı cache eklentisi aynı anda aktif olursa veya benzer işlevleri yerine getiren eklentiler birlikte kullanılırsa beyaz ekran hatası oluşabilir.

Tema sorunları da sık karşılaşılan bir nedendir. Temanızı güncelledikten sonra veya yeni bir tema aktif ettikten sonra beyaz ekran görüyorsanız, tema kodunda bir hata olabilir. Özellikle kalitesiz veya uzun süredir güncellenmeyen temalar, yeni WordPress versiyonlarıyla uyumsuz olabilir. Bazen tema dosyasında küçük bir yazım hatası bile tüm siteyi çökertebilir.

PHP hafıza limiti, WordPress sitelerinin sıklıkla karşılaştığı bir sorundur. WordPress çalışırken belirli bir miktar sunucu hafızası kullanır. Eğer siteniz bu hafıza limitine ulaşırsa, sunucu sayfayı yüklemeyi durdurur ve beyaz ekran gösterir. Özellikle çok sayıda eklenti kullanan, büyük görseller barındıran veya yüksek trafikli siteler hafıza sorunları yaşayabilir. Hosting’inizin varsayılan hafıza limiti yetersiz olabilir.

Kod hataları, özellikle functions.php dosyasına manuel kod eklediyseniz ortaya çıkabilir. Bir parantez unutmak, noktalı virgül eksik koymak veya yanlış bir fonksiyon adı yazmak gibi küçük hatalar bile WordPress’in çalışmasını durdurabilir. Bu nedenle kod düzenlemeleri yaparken her zaman yedek almak ve dikkatli olmak çok önemlidir.

Dosya izinleri, Linux tabanlı sunucularda kritik öneme sahiptir. WordPress’in belirli dosyalara yazma veya okuma izni olmazsa, sistem düzgün çalışamaz ve beyaz ekran gösterebilir. Özellikle sunucu değişikliklerinden sonra veya manuel FTP işlemlerinden sonra dosya izinleri bozulmuş olabilir.

Veritabanı bağlantı sorunları da beyaz ekran hatasına yol açabilir. WordPress, tüm içeriklerinizi ve ayarlarınızı bir veritabanında saklar. Eğer veritabanına bağlantı kopmuşsa, kullanıcı adı veya şifre yanlışsa ya da veritabanı sunucusu çalışmıyorsa, site yüklenemez ve beyaz ekran gösterir.

İlk Müdahale ve Hızlı Çözümler

Yenileme ve farklı tarayıcı denemesi, en basit ama bazen işe yarayan ilk adımdır. Sayfayı birkaç kez yenileyin (F5 tuşu), tarayıcınızın önbelleğini temizleyin (Ctrl+Shift+Delete) ve farklı bir tarayıcıda deneyin. Bazen sorun sitenizde değil, tarayıcınızın önbelleğinde olabilir. Ayrıca, mobil cihazdan veya farklı bir internet bağlantısından erişmeyi deneyin. Eğer başka cihazlarda site açılıyorsa, sorun yereldir.

Cache temizleme, özellikle cache eklentisi kullanıyorsanız denenmesi gereken ilk adımdır. Ancak beyaz ekran nedeniyle yönetim paneline erişemiyorsanız, FTP üzerinden cache klasörünü manuel olarak silebilirsiniz. /wp-content/cache/ klasörünü bulun ve içindeki tüm dosyaları silin. Ayrıca, CDN kullanıyorsanız (Cloudflare gibi) CDN cache’ini de temizleyin.

Debug modunu aktifleştirme, hatanın nedenini görmek için kritik bir adımdır. WordPress varsayılan olarak hata mesajlarını göstermez ama siz aktifleştirebilirsiniz. FTP ile sitenize bağlanın, wp-config.php dosyasını indirin ve bir metin editöründe açın. Şu satırı bulun:

define('WP_DEBUG', false);

Bunu şöyle değiştirin:

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

Bu ayarlar, hataları /wp-content/debug.log dosyasına kaydeder ama ekranda göstermez. Dosyayı kaydedin, sunucuya yükleyin ve sitenizi tekrar açın. Ardından debug.log dosyasını kontrol edin; hangi eklenti veya temadan hata geldiğini görebilirsiniz.

Hosting destek ekibine ulaşmak, özellikle teknik bilginiz yoksa akıllıca bir adımdır. Çoğu kaliteli hosting firması 7/24 destek sağlar ve beyaz ekran hatası gibi yaygın sorunlarda hızlıca yardımcı olabilir. Destek ekibi, sunucu loglarını kontrol edebilir, hafıza limitlerini artırabilir veya sorunlu dosyayı tespit edip düzeltebilir.

Eklenti ve Tema Sorunlarını Çözme

Tüm eklentileri devre dışı bırakma, beyaz ekran hatasını çözmenin en etkili yöntemlerinden biridir. Ancak yönetim paneline erişemediğiniz için bunu FTP üzerinden yapmanız gerekir. FTP programınızla (FileZilla, Cyberduck vb.) sitenize bağlanın. /wp-content/ klasörüne gidin ve plugins klasörünü bulun. Bu klasörün adını geçici olarak değiştirin, örneğin plugins-old yapın. Bu işlem tüm eklentileri devre dışı bırakır.

Şimdi sitenizi tekrar açmayı deneyin. Eğer site açıldıysa, sorun eklentilerden birindedir. plugins-old klasörünü tekrar plugins olarak adlandırın. Ardından her eklentinin klasörünü tek tek yeniden adlandırarak hangisinin soruna neden olduğunu bulun. Örneğin, plugin-name klasörünü plugin-name-off yapın, siteyi kontrol edin. Sorunlu eklentiyi bulana kadar bu işlemi tekrarlayın.

Temayı varsayılana çevirmek, tema kaynaklı sorunları çözmenin yoludur. FTP ile /wp-content/themes/ klasörüne gidin. Aktif temanızın klasörünü yeniden adlandırın. WordPress otomatik olarak varsayılan temaya (Twenty Twenty-Four gibi) geçecektir. Eğer site açıldıysa, sorun temanızdadır. Tema güncellemesi yapın, temayı yeniden yükleyin veya başka bir tema kullanmayı düşünün.

Eklenti çakışmasını tespit ettikten sonra yapılacaklar şunlardır: sorunlu eklentinin alternatifini bulun, eklentinin geliştiricisine hata bildirin, eklenti güncelleme olup olmadığını kontrol edin. Bazı durumlarda, eski bir eklenti versiyonuna dönmek sorunu çözebilir. WP Rollback gibi eklentiler, eski versiyonlara dönüş yapmanızı sağlar ama FTP’den manuel kurulum da yapabilirsiniz.

Hafıza ve Sunucu Ayarlarını Optimize Etme

PHP hafıza limitini artırma, birçok beyaz ekran sorununu çözen basit bir yöntemdir. Bunu üç farklı şekilde yapabilirsiniz. İlk yöntem: wp-config.php dosyasını düzenleyin ve şu satırı ekleyin:

define('WP_MEMORY_LIMIT', '256M');

Bu satırı /* That's all, stop editing! */ satırından hemen önce ekleyin. Dosyayı kaydedin ve sunucuya yükleyin.

İkinci yöntem: .htaccess dosyasını düzenleyin. Dosyanın sonuna şu satırı ekleyin:

php_value memory_limit 256M

Üçüncü yöntem: php.ini dosyası oluşturma veya düzenleme (hosting izin veriyorsa). Sitenizin kök dizininde php.ini dosyası oluşturun ve içine şunu yazın:

memory_limit = 256M

Maksimum yürütme süresini artırma, uzun süren işlemlerde zaman aşımını önler. .htaccess dosyasına şu satırları ekleyin:

php_value max_execution_time 300
php_value max_input_time 300

Veya php.ini dosyasında:

max_execution_time = 300
max_input_time = 300

Bu ayarlar, PHP script’lerinin 300 saniye (5 dakika) çalışmasına izin verir. Özellikle büyük görselleri işlerken veya yedek alırken faydalıdır.

Hosting destek ekibinden yardım alma, bazen en pratik çözümdür. Kaliteli hosting firmaları, sunucu tarafında hafıza limiti, PHP versiyonu veya diğer ayarları kolayca değiştirebilir. Destek talebi açın, “beyaz ekran hatası aldım, hafıza limitini artırır mısınız?” deyin. Çoğu firma 24 saat içinde bu işlemi ücretsiz yapar.

Kod Hatalarını Tespit ve Düzeltme

Functions.php hatalarını bulma, en yaygın kod hatasıdır. Eğer son olarak functions.php dosyasına kod eklediyseniz ve ardından beyaz ekran gördüyseniz, büyük ihtimalle eklediğiniz kodda hata vardır. FTP ile /wp-content/themes/[tema-adınız]/functions.php dosyasını indirin. Son eklediğiniz kodu geçici olarak silin veya yorum satırı yapın (başına // ekleyin). Dosyayı kaydedin, sunucuya yükleyin ve kontrol edin.

Debug.log dosyasını okuma, hangi satırda hata olduğunu gösterir. Debug modunu aktifleştirdiyseniz, /wp-content/debug.log dosyasını indirin ve bir metin editöründe açın. Genellikle şöyle satırlar görürsünüz:

PHP Fatal error: Cannot redeclare function... in /wp-content/themes/yourtheme/functions.php on line 45

Bu mesaj, hangi dosyada (functions.php) ve hangi satırda (45) hata olduğunu tam olarak gösterir.

Syntax hatalarını düzeltme, dikkat gerektirir. Yaygın hatalar:

• Eksik noktalı virgül (;)
• Eksik parantez kapatma (}, ), ])
• Yanlış fonksiyon adı
• Tırnak işaretlerinin yanlış kullanımı

Bu hataları düzeltirken, kodu notepad++ veya Visual Studio Code gibi kod editörlerinde açın; bu editörler syntax renklendirme yapar ve hataları bulmayı kolaylaştırır.

Yedekten geri yükleme, kod hatalarında en güvenli yoldur. Eğer düzenli yedek alıyorsanız, son çalışan yedeği geri yükleyin. UpdraftPlus gibi yedekleme eklentileri kullanıyorsanız, FTP ile wp-content/updraftplus klasöründeki yedek dosyalarını bulabilir ve manuel olarak geri yükleyebilirsiniz.

Veritabanı Sorunlarını Çözme

Veritabanı bağlantı hatası, bazen beyaz ekran olarak görünebilir. wp-config.php dosyasında veritabanı bilgilerini kontrol edin:

define('DB_NAME', 'veritabani_adi');
define('DB_USER', 'kullanici_adi');
define('DB_PASSWORD', 'sifre');
define('DB_HOST', 'localhost');

Bu bilgilerin doğru olduğundan emin olun. Hosting kontrol panelinizden (cPanel gibi) veritabanı bilgilerinizi kontrol edebilirsiniz.

Veritabanı onarma, bozuk tablolardan kaynaklanan sorunları çözer. wp-config.php dosyasına şu satırı ekleyin:

define('WP_ALLOW_REPAIR', true);

Ardından tarayıcınızda şu adresi açın:

https://www.siteniz.com/wp-admin/maint/repair.php

Bu sayfa veritabanınızı kontrol edip onarma seçeneği sunar. İşlem tamamlandıktan sonra, güvenlik nedeniyle eklediğiniz satırı wp-config.php’den silin.

phpMyAdmin üzerinden manuel kontrol, ileri seviye bir yöntemdir. Hosting kontrol panelinizden phpMyAdmin’e girin, WordPress veritabanınızı seçin. wp_options tablosunu açın (wp_ yerine sitenizin prefix’i olabilir). siteurl ve home satırlarındaki URL’lerin doğru olduğundan emin olun. Yanlışsa, düzenle butonuyla düzeltin.

Kalıcı Çözümler ve Önleyici Tedbirler

Düzenli yedekleme alışkanlığı, en önemli koruyucu tedbir olarak kabul edilmelidir. UpdraftPlus, BackupBuddy veya VaultPress gibi yedekleme eklentileri kurun ve otomatik günlük yedek alacak şekilde ayarlayın. Yedekler hem dosyaları hem veritabanını içermeli ve off-site lokasyonda (Google Drive, Dropbox) saklanmalıdır.

Staging ortamında test yapma, değişiklikleri canlı sitede yapmadan önce güvenli ortamda denemenizi sağlar. Birçok hosting firması (Kinsta, WP Engine, SiteGround) tek tıkla staging ortamı sunar. Eklenti güncellemeleri, tema değişiklikleri ve kod eklemeleri önce staging’de test edilmelidir.

Güvenilir eklenti ve tema kullanma, kalite kontrolü açısından önemlidir. WordPress.org deposundan indirilen ücretsiz eklentiler veya ThemeForest gibi güvenilir marketlerden alınan premium temalar tercih edilmelidir. Bilinmeyen kaynaklardan indirilen nulled (korsanlanmış) temalar hem güvenlik riski hem de beyaz ekran sorunlarına yol açar.

Hosting kalitesine yatırım yapmak, uzun vadede birçok sorunu önler. Çok ucuz shared hosting planları, sınırlı hafıza ve işlemci gücü nedeniyle sık sık beyaz ekran ve performans sorunlarına neden olur. Kaliteli bir hosting (SiteGround, Kinsta, WP Engine) biraz daha pahalı olsa da kesintisiz hizmet ve profesyonel destek sağlar.

---

WordPress beyaz ekran hatası çözümü, genellikle panik yaratıcı görünse de doğru adımları izleyerek kısa sürede halledilebilir bir sorundur. WebAcil olarak, beyaz ekran ve tüm WordPress teknik sorunlarında 7/24 acil destek hizmeti sunuyoruz. Siteniz çöktüğünde, hızlı müdahale ile verilerinizi koruyarak sistemi saatler içinde ayağa kaldırıyoruz. Teknik sorunlarla uğraşmak yerine işinize odaklanmak ve sitenizin güvenli ellerde olduğunu bilmek için bugün bizimle iletişime geçin!