WordPress sitenizde ani bir hata mesajıyla karşılaşmak can sıkıcı olabilir. Beyaz ekran, bağlantı reddi ya da güncelleme sırasında takılı kalmak… Bu sorunlar çoğu zaman basit adımlarla çözülebilir. Bu yazıda en sık karşılaşılan 10 WordPress hatasını, neden oluştuklarını ve onları hızlıca nasıl düzeltebileceğinizi bulacaksınız. Her adımı net bir şekilde anlattık; böylece teknik bilgi seviyeniz ne olursa olsun uygulayabilirsiniz.
1. WordPress Beyaz Ölüm Ekranı (WSoD)
Sitenize girdiğinizde boş bir beyaz sayfa görüyorsanız, büyük ihtimalle WSoD ile karşı karşıyasınız. Bu hata genellikle bellek sınırının aşılmasından, uyumsuz bir eklentiden ya da temadan kaynaklanır. Bazen hata yalnızca yönetici panelinde, bazen de sitenin tamamında ortaya çıkar.
Nasıl çözülür?
İlk olarak wp-config.php dosyanızda bellek limitini artırın. Dosyaya şu satırı ekleyin:
define('WP_MEMORY_LIMIT', '256M');
Eğer sorun devam ederse, FTP üzerinden /wp-content/plugins/ klasörünün adını geçici olarak değiştirerek tüm eklentileri devre dışı bırakın. Site düzelirse, sorunlu eklentiyi bulmak için eklentileri tek tek aktif edin. Tema kaynaklı olup olmadığını anlamak içinse varsayılan bir WordPress temasına (Twenty Twenty-Four gibi) geçiş yapın.
Bellek limitini artırmak geçici bir çözüm olabilir; asıl hedef aşırı kaynak tüketen bir eklenti veya temayı tespit etmek olmalı. Ayrıca PHP hata günlüklerini kontrol etmek, hatanın kaynağını gösteren ipuçları verir.
2. Veritabanı Bağlantı Hatası
“Veritabanına bağlanırken hata oluştu” mesajı, sitenizin veritabanıyla iletişim kuramadığını gösterir. Bunun en yaygın sebepleri yanlış veritabanı bilgileri, bozuk bir veritabanı ya da sunucu kaynaklı kesintilerdir.
Adım adım düzeltme
- wp-config.php dosyasını kontrol edin:
DB_NAME,DB_USER,DB_PASSWORDveDB_HOSTdeğerlerinin doğruluğundan emin olun. Sunucu taşıdıysanız bu bilgiler değişmiş olabilir. - Veritabanını onarın:
wp-config.phpdosyasınadefine('WP_ALLOW_REPAIR', true);ekleyin, ardındansiteadiniz.com/wp-admin/maint/repair.phpadresine giderek onarım aracını çalıştırın. İşlem bitince bu satırı kaldırmayı unutmayın. - Sunucu ile iletişime geçin: Eğer sorun sunucu tarafındaysa (MySQL hizmeti durmuş olabilir) hosting sağlayıcınızın destek ekibine danışın.
Özellikle yoğun trafik alan sitelerde, veritabanı sunucusunun limitleri aşılmış olabilir. Bu durumda hosting planınızı yükseltmek gerekebilir.
3. 403 Yasak Hatası
403 Forbidden hatası, sunucunun sayfaya erişim izni vermediği anlamına gelir. WordPress’te genelde yanlış dosya izinleri, güvenlik eklentileri veya bozuk bir .htaccess dosyası bu hataya yol açar.
Hızlı çözüm yolları
Dosya izinlerini bir FTP istemcisiyle kontrol edin. Klasörler için 755, dosyalar için 644 izinleri standarttır. .htaccess dosyasını yeniden oluşturmak içinse Ayarlar > Kalıcı Bağlantılar ekranına gidip hiçbir değişiklik yapmadan kaydedin. WordPress otomatik olarak yeni bir .htaccess oluşturacaktır. Güvenlik eklentilerini geçici olarak devre dışı bırakmak da hatanın kaynağını anlamanıza yardımcı olur.
Not: Eğer bir güvenlik duvarı (firewall) veya CDN kullanıyorsanız, IP’nizin engellenip engellenmediğini kontrol edin.
4. 404 Sayfa Bulunamadı Hatası
404 hatası genellikle kalıcı bağlantı (permalink) ayarlarının bozulmasıyla ortaya çıkar. Sayfalar yayında olsa bile, WordPress doğru URL’yi üretemez. Özellikle site taşıma veya sunucu değişikliği sonrası sık görülür.
Çözmek için
Ayarlar > Kalıcı Bağlantılar bölümüne gidip tercih ettiğiniz yapıyı seçin ve değişiklikleri kaydedin. Bu işlem .htaccess dosyasını yeniler. Eğer düzelmezse, Apache sunucularda mod_rewrite modülünün aktif olduğundan emin olun. Nginx kullanıyorsanız, yapılandırma dosyanıza WordPress için gerekli yeniden yazma kurallarını eklemeniz gerekebilir.
Bazı durumlarda eklenti çakışmaları da 404’e neden olur. Eklentileri topluca devre dışı bırakıp test etmek iyi bir yoldur.
5. WordPress Güncellemesinde Takılma
Otomatik güncelleme sırasında site kilitlenebilir ve “bakım modu” mesajıyla karşılaşabilirsiniz. Bu durum çoğu zaman eksik dosya transferinden ya da sunucu zaman aşımından (timeout) kaynaklanır.
Manuel kurtarma adımları
FTP ile ana dizinde .maintenance adında bir dosya göreceksiniz. Bu dosyayı silmek bakım modunu kaldırır. Ardından güncellemeyi manuel olarak tamamlayın:
- WordPress’in son sürümünü wordpress.org’dan indirin.
wp-contentklasörü hariç tüm dosyaları sunucuya yükleyin (mevcut dosyaların üzerine yazın).- Yönetim paneline gittiğinizde veritabanı güncellemesi gerekiyorsa WordPress sizi yönlendirecektir.
Yükleme öncesinde mutlaka yedek alın. Güncelleme esnasında sunucuda yeterli boş alan olduğundan ve PHP zaman aşımı süresinin yeterince uzun olduğundan emin olun.
6. Eklenti veya Tema Güncelleme Hataları
Bir eklentiyi güncelledikten sonra siteniz bozulduysa, genellikle uyumluluk sorunu vardır. Bazen sunucu izinleri nedeniyle güncelleme tamamlanamaz ve eklenti yarı yüklenmiş kalır.
Pratik çözüm
FTP ile /wp-content/plugins/ altındaki sorunlu eklentinin klasörünü silin veya adını değiştirin. WordPress o eklentiyi devre dışı bırakacaktır. Site normale döndükten sonra, eklentinin uyumlu bir sürümünü bulup manuel olarak yükleyebilir ya da alternatif bir eklenti arayabilirsiniz.
Temalar için de benzer bir yol izleyin; /wp-content/themes/ altındaki klasörü devre dışı bırakıp varsayılan temaya geçiş yapabilirsiniz. Eğer güncelleme sırasında “destinasyon klasörü zaten var” hatası alıyorsanız, eklentinin eski sürümünden kalan klasörü FTP’den silmek sorunu çözer.
7. Karışık İçerik Uyarısı (Mixed Content)
SSL sertifikası yükledikten sonra tarayıcıda “güvenli değil” uyarısı alıyorsanız, sitenizde hem HTTP hem HTTPS bağlantıları karışık halde demektir. Bu durum ziyaretçiler için güvenlik riski oluşturur ve SEO’yu olumsuz etkiler.
Nasıl temizlenir?
Öncelikle Ayarlar > Genel kısmında WordPress Adresi (URL) ve Site Adresi (URL) alanlarını HTTPS olarak güncelleyin. Ardından veritabanındaki eski HTTP bağlantılarını güncellemek için Really Simple SSL gibi bir eklenti kullanabilir ya da WP-CLI ile arama-değiştirme yapabilirsiniz. Medya dosyalarının ve tema kaynaklarının da HTTPS üzerinden çağrıldığını kontrol edin.
Not: Eklenti kullanmak hızlı bir çözümdür, ancak kalıcı olması için veritabanındaki tüm URL’lerin HTTPS’e dönüştürüldüğünden emin olun. Aksi takdirde ileride eklentiyi devre dışı bıraktığınızda sorun geri dönebilir.
8. WordPress Site Taşıma Sonrası Bozuk Bağlantılar
Siteyi yeni bir sunucuya veya alan adına taşıdığınızda, eski URL’ler veritabanında kaldığı için bağlantılar kırılır, görseller yüklenmez. Bu sorun özellikle manuel taşımalarda sık görülür.
Adım adım taşıma sonrası düzeltme
- Veritabanını dışa aktarıp bir metin düzenleyicide eski alan adını yeni alan adıyla değiştirin. Büyük veritabanlarında bu riskli olabilir; Better Search Replace gibi bir eklentiyle işlemi yapmak daha güvenlidir. (Dikkat: bu eklentiyi sadece taşıma sonrası geçici olarak kullanıp hemen kaldırın.)
- Medya dosyalarının yollarını düzeltmek için yukarıdaki arama-değiştirme işlemi genellikle yeterlidir.
- Kalıcı bağlantıları güncellemek için Ayarlar > Kalıcı Bağlantılar sayfasını ziyaret edip kaydedin.
Eğer site adresi değiştiyse, wp-config.php dosyasına sabit URL tanımları ekleyebilirsiniz: define('WP_HOME','https://yenialanadiniz.com'); ve define('WP_SITEURL','https://yenialanadiniz.com');.
9. WordPress Giriş Sayfasına Erişememe
Yönetici paneline giremiyorsanız ve şifre sıfırlama e-postası da gelmiyorsa, işin içine başka etkenler girmiş demektir. Bu sorun genelde güvenlik eklentilerinin IP engellemesinden, .htaccess kurallarından veya veritabanındaki URL farklılığından kaynaklanır.
Alternatif erişim yöntemleri
FTP ile /wp-content/plugins/ altındaki güvenlik eklentisinin klasörünü geçici olarak taşıyın. Erişim düzelirse, eklentinin ayarlarındaki IP kara listesini kontrol edin. .htaccess dosyasını yedekleyip sıfırlayın (varsayılan WordPress kurallarıyla yeniden oluşturun). Veritabanı üzerinden şifre sıfırlamak için phpMyAdmin aracıyla wp_users tablosuna MD5 hashli yeni bir şifre girebilirsiniz.
Site URL’siyle oynanmış olabileceğini de unutmayın; wp-config.php içindeki URL sabitlerini kontrol edin.
10. WordPress Yavaşlığı ve Performans Sorunları
Sitenizin yavaşlaması birden fazla hatayı tetikleyebilir ve kullanıcı deneyimini doğrudan etkiler. Yavaşlığın altında genellikle optimize edilmemiş görseller, şişkin bir veritabanı, kalitesiz hosting veya çok sayıda eklenti yatar.
Hızlandırma adımları
- Önbellek kullanın: W3 Total Cache, WP Super Cache gibi eklentiler sayfa yükünü ciddi şekilde azaltır.
- Görselleri optimize edin: Smush veya ShortPixel ile görselleri sıkıştırın; mümkünse WebP formatına dönüştürün.
- Gereksiz eklentileri temizleyin: Kullanmadığınız eklentileri silin; sadece devre dışı bırakmak bile bazı kaynakları tüketmeye devam edebilir.
- Veritabanını düzenleyin: WP-Optimize eklentisi ile revizyonları, spam yorumları ve geçici verileri temizleyin.
- Hosting kalitesini değerlendirin: Paylaşımlı hostingler kaynak sınırı nedeniyle yavaşlığa yol açabilir; sitenizin trafiğine uygun bir VPS veya yönetimli WordPress hosting düşünün.
Yavaşlığa neden olan etkenleri anlamak için PageSpeed Insights veya GTmetrix gibi araçlardan rapor alın. Unutmayın, hızlı bir site sadece ziyaretçi memnuniyeti değil, aynı zamanda bir sıralama sinyalidir.
Sorun Kalıcı Olarak Nasıl Önlenir?
Bu rehberdeki hataların çoğu düzenli bakım ve bilinçli kullanımla önlenebilir. Aşağıdaki önlemleri rutin haline getirin:
- Otomatik yedekleme kurun: UpdraftPlus, BlogVault gibi bir eklentiyle haftalık yedekler alın ve bunları bulut depolamada saklayın.
- Güncellemeleri zamanında yapın: WordPress çekirdek, tema ve eklenti güncellemelerini aksatmayın; ancak ana güncellemeleri önce bir hazırlık (staging) ortamında test edin.
- Güvenlik önlemleri alın: Wordfence veya Sucuri gibi bir güvenlik eklentisi kullanın, güçlü parolalar belirleyin ve giriş denemelerini sınırlayın.
- Sadece gerekli eklentileri yükleyin: Her yeni eklenti potansiyel bir uyumluluk riskidir; ihtiyacınız olmayan işlevler için eklenti kurmaktan kaçının.
- Bir bakım günlüğü tutun: Yaptığınız değişiklikleri, karşılaştığınız sorunları ve çözümleri not edin. Bu, tekrarlayan sorunlarda size zaman kazandırır.
Bu maddeleri uygulayarak sitenizin çalışma süresini artırır ve olası hataları en aza indirirsiniz. Karşılaştığınız hatayı bu yazıdaki adımlarla çözemediyseniz, hosting sağlayıcınızın destek ekibi genellikle sunucu tarafındaki sorunları hızlıca tespit edebilir.
Beyaz ekran benim de baş belam oldu.
Veritabanı hatasında sunucu kesintisini nasıl teyit edebiliriz?
Bellek limitini yükseltince temam düzelmişti, geçici çözüm sandım ama burada da öyle diyor.
Eklentileri tek tek açmak riskli değil mi? Canlı sitede denemekten çekiniyorum, hata tekrar eder diye.
Geçenlerde güncelleme sırasında site takılı kaldı, meğer uyumsuz bir önbellek eklentisiymiş. Buradaki adımları uygulamak işe yaradı ama hangi sırayla deneyeceğimi şaşırdım. Bellek limiti artırmak ilk iş olarak iyi fikir.
Sadece wp-config’e bellek eklemek bazen yetmez.
PHP hata günlüklerine nereden bakacağımızı da ekleseydiniz keşke. Hosting panelinden mi oluyor yoksa dosya yöneticisinde ayrı bir klasörde mi?
On numara özet olmuş, hemen kaydettim.
Veritabanı bağlantı hatasında db_host değerini localhost dışında bir şey yazmak gerektiğini duymuştum, doğru mu? Sunucuya göre değişiyormuş, mesela bazı hostinglerde IP adresi girmek gerekiyormuş. Bu makalede değinilmemiş.