WordPress dünyasına adım attığınızda, zaman zaman bazı hatalarla karşılaşmanız kaçınılmaz. İster yeni başlayan biri olun, ister yıllardır WordPress kullanan deneyimli bir site yöneticisi, bu hatalar herkese musallat olabiliyor. Bu hataların çoğu düşündüğünüzden çok daha basit çözümlere sahip. Bu rehberde, karşılaşabileceğiniz en yaygın WordPress hatalarını ve bunların pratik çözümlerini adım adım anlatacağız. Amacımız, bir sonraki hatayla karşılaştığınızda panik yapmadan, kendiniz çözebilecek bilgi ve beceriyle donanmanız.
WordPress, dünyanın en popüler içerik yönetim sistemi olmasına rağmen, zaman zaman beklenmedik sorunlar yaşatabilir. Bu sorunların çoğu, yanlış yapılandırmalardan, uyumsuz eklentilerden veya güncel olmayan yazılımlardan kaynaklanır. Ancak endişelenmeyin, bu hatalar genellikle kalıcı hasarlara yol açmaz ve çoğu durumda birkaç basit adımla çözülebilir.
1. WordPress Ayrıştırma veya Sözdizimi Hatası
WordPress söz dizimi hatası genellikle kodlarda bulunan bir hatadan kaynaklanır; eksik bir noktalı virgül, fazladan bir parantez veya herhangi bir gramer hatası tüm komut dosyasını etkileyip web sitenizi erişilmez hale getirebilir. Sözdizimi hatası WordPress yönetim paneline erişimi de engeller, bu nedenle yaptığınız değişiklikleri geri almak için cPanel ya da FTP kullanmanız gerecek. Hangi dosyaları ve satırları düzenlemeniz gerektiği zaten hata mesajı aracılığıyla bildirilir. Eğer hata mesajı yerine boş bir sayfa varsa, hatayı bulmak için wp-config.php dosyanıza aşağıdaki kod satırını ekleyin: define( 'WP_DEBUG', true );
Yukarıdaki kod dosyanızda varsa false kısmını true olarak değiştirip sayfayı kaydedin. Dosyayı kaydettikten ve web sitenizi tarayıcınızda yeniledikten sonra, dosya, isim ve satır numarası dahil olmak üzere hatanın yerini belirten bir metin dizesi görmelisiniz. Bundan sonra yapmanız gereken, o hatanın bulunduğu klasöre gitmek ve hataya neden olan kodu düzenlemek (ya da silmek) olacak. Daha fazla detay için “WordPress Sözdizimi Hatası (Syntax Error) Çözümü” başlıklı kılavuzumuza göz atabilirsiniz.
2. Dahili Sunucu Hatası (500 Internal Server Error)
500 Internal Server Error, WordPress’te sıkça karşılaşılan ancak nedeni belirlemesi zor olan hatalardan biridir. Genellikle sunucu tarafında bir sorun olduğunu gösterir, ancak asıl neden sitenizin dosyalarından kaynaklanabilir. Bu hata, .htaccess dosyası bozulması, PHP bellek sınırı aşımı veya bozuk eklentilerden kaynaklanabilir.
- Bozuk .htaccess dosyası
- PHP bellek sınırı
- Tarayıcı ön belleği
- Bozuk veritabanı
- Bozuk WordPress çekirdek dosyaları
- Veritabanı sunucunuzla ilgili sorunlar
- Eklenti ve temalardan kaynaklı sorunlar
- Yanlış dosya ve klasör izinleri
- İşte bu sorunu nasıl düzelteceğinizi gösteren kapsamlı bir kılavuz: “WordPress 500 Internal Server Error Çözümü“
3. Veritabanı Bağlantı Hatası
En sık görülen WordPress hatalarından biri olan Error establishing a database connection (Veritabanı bağlantısı kurulurken hata oluştu) sorunu genellikle veritabanındaki yanlış bilgiler, veritabanı sunucusunun çalışmaması veya veritabanı dosyalarında oluşan bir hatadan kaynaklanabilir. Veritabanı, WordPress’in gönderiler, sayfalar ve diğer önemli bilgiler gibi tüm içeriğinizi kaydettiği yerdir. Dolayısıyla, veritabanı olmadan siteniz çalışmaz. Bu nedenle, böyle bir hatayla karşılaşırsanız hızlıca düzeltmeniz gerekir. İşte, bunun için uygulayabileceğiniz çözümleri içeren kılavuzumuz: “WordPress Veritabanı Bağlantı Hatası Çözümü“
4. Beyaz Ekran Hatası
WordPress kullanıcılarının en büyük kabusu diyebiliriz. Sitenizi açtığınızda karşınıza bomboş beyaz bir ekran çıkıyor, hiçbir hata mesajı görmüyorsunuz. Bu duruma “White Screen of Death” veya kısaca WSOD deniyor. Sitenin tamamı etkilendiğinde, bunun bir WordPress sorunu mu, internet sorunu mu yoksa ana bilgisayar sorunu mu olduğundan emin olmak zordur. Çünkü ekranda bu hatanın nedenine dair herhangi bir bildirim olmaz. Bu nedenle farklı çözüm yollarını denemeniz gerekir. Detaylı içeriğimize göz atabilirsiniz: “WordPress Beyaz Ekran Hatası Çözümü“
- PHP Bellek Sınırı– En yaygın sebep budur. Siteniz çalışmak için yeterli belleğe sahip değildir. wp-config.php dosyasına
define('WP_MEMORY_LIMIT', '256M');satırını ekleyerek php limitini artırabilirsiniz. - Eklenti Çakışması– Yeni yüklediğiniz bir eklenti başka eklentilerle çakışıyor olabilir. FTP ile siteye bağlanın.
wp-content/pluginsklasörünü yeniden adlandırın. Site açıldıysa eklentileri tek tek aktifleştirin. - Tema Sorunu– Aktif temanızda bir hata oluşmuş olabilir. FTP ile themes klasörüne gidin. Aktif tema klasörünü yeniden adlandırın. WordPress varsayılan temaya dönecektir. Sorun çözüldüyse önceki tema yerine başka temaya geçebilir ya da tema geliştiricisinden destek alabilirsiniz.
5. Resim Yükleme Hatası
WordPress’te resim yükleme sorunları genellikle hatalı dosya ve klasör izinlerinden kaynaklanır. Yanlış dosya izinleri, WordPress’in dosyaları okumasını veya yüklemesini engeller. Hatalı bir eklenti, sunucu dosyalarındaki bir hata veya sitenizin saldırıya uğraması gibi farklı nedenlerle izinlerin değişmesi bu hatanın nedeni olabilir. İşte, hatayı düzeltmenize yardımcı olabilecek bir kılavuz: “WordPress Resim Yükleme Hatası Çözümü“
6. 403 Forbidden Error Sorunu
403 Forbidden Error veya Türkçe karşılığıyla 403 Yasak Hatası, WordPress kullanıcılarının karşılaşabileceği en yaygın hatalardan biridir, ancak çözümü paniğe kapılacak kadar zor değildir. 403 Forbidden hatası, web sunucunuzun tarayıcınızla iletişim kurmak için kullandığı bir HTTP durum kodudur. WordPress’te 403 Forbidden hatasının en olası nedenleri şunlardır:
- Yanlış dosya izinleri
- Kullanılan bir eklenti
- Bozuk
.htaccessdosyası
Bu sorunu çözmenize yardımcı olabilecek kılavuz: “403 Forbidden Error Çözümü“
7. Düzenleyici Beklenmeyen Bir Hatayla Karşılaştı
Bu sorun eklenti ve tema kodlarında çakışmalar gibi pek çok farklı nedenden kaynaklanabilir. Ancak, hata oluştuğunda yeni eklenti ve tema yüklemediyseniz ya da herhangi bir güncelleme yapmadıysanız, süresi dolmuş eski önbellek nedeniyle “Düzenleyici beklenmeyen bir hatayla karşılaştı” hatasını görmüş olabilirsiniz. Bu sorunu çözmek için deneyebileceğiniz farklı çözümleri içeren kılavuzumuzdan faydalanabilirsiniz: “WordPress: ‘Düzenleyici beklenmeyen bir hatayla karşılaştı’ Çözümü“
8. Bağlantı Zaman Aşımı Hatası (Connection Timed Out)
Sitenizin yüklenmesi uzun sürüyorsa ve sonunda sitenin kullanılamadığına dair bir hata alıyorsanız, bağlantınız zaman aşımına uğradı demektir. Bu durum, özellikle sınırlı kaynaklara sahip olan paylaşımlı hostinglerde görülür. Siteniz sunucunun kaldırabileceğinden daha fazlasını yapmaya çalıştığında bu yaygın WordPress hatasıyla karşılaşmanız muhtemeldir.
- Bunu çözmek için;
- Cache eklentisi ayarlarını optimize edin.
- Bellek ve yürütme süresini artırın: .htaccess’e
php_value max_execution_time 60satırını ekleyin. - Hosting’i yükseltin: VPS’e geçmek, uzun vadeli çözüm.
- Detaylı çözüm için: ERR_CONNECTION_TIMED_OUT Hatası Çözümü
9. Error 522 Hatası
Error 522 : Connection timed out (bağlantı zaman aşımına uğradı) hatası, Cloudflare’in web barındırma sunucunuza erişemediğini gösteren bir hatadır. Aslında bu sorun direkt olarak CloudFlare’den kaynaklı bir hata değildir; 5xx durum kodları sunucu kaynaklı hatalardır. Bununla birlikte, Cloudflare ile kaynak sunucu arasındaki iletişim başarısız olduğunda, “Hata 522: bağlantı zaman aşımına uğradı” mesajıyla karşılaşabilirsiniz. İşte çözüm yollar: “CloudFlare Error 522 –Hatası [Çözüm]“
10.Tema style.css Stil Dosyası İçermiyor
Tema yüklerken veya etkinleştirirken böyle bir sorunla karşılaşıyorsanız, hemen paniğe kapılmanıza gerek yok. Bu hata mesajı, satın aldığınız temanın bozuk olduğu anlamına gelmez, genellikle hatalı bir yükleme yaptığınız anlamına gelir. WordPress tema style.css stil sayfası içermiyor hatasının çözümü genellikle basittir. İşte çözüm kılavuzumuz: “WordPress Tema style.css Stil Dosyası İçermiyor Hatası“
11. Ayrıştırılamayan Yapılandırılmış Veri Hatası
Bu sorun direkt WordPress siteleri için geçerli bir hata olmasa da, sıklıkla karşılaşılan bir problemdir. Search Consol raporlarında zaman zaman Ayrıştırılamayan Yapılandırılmış Veri hatası uyarıları görebilirsiniz. Yalnız bu konuda endişelenmenize gerek yok. Çünkü bu çözülmesi en kolay yapısal veri sorunlarından biridir. Google Search Console, yapılandırılmış verilerinizde herhangi bir hata tespit ettiğinde sizi e-posta yoluyla uyarır. Bu hatanın çözümünü içeren kılavuzumuza göz atabilirsiniz: “Ayrıştırılamayan Yapılandırılmış Veri Hatası Çözümü“
12. Yetersiz Bellek Hatası
Web sunucularının, aynı anda birden çok uygulamayı verimli bir şekilde çalıştırmaları için belleğe ihtiyaçları vardır. Sunucular, PHP dahil olmak üzere farklı uygulamalara belirli bir bellek boyutu tahsis ederler. Varsayılan ayrılmış bellek boyutu yetersiz geldiğinde veya bellek sınırına ulaşıldığında, genellikle WordPress Memory Limit hataları oluşur. En yaygın WordPress hataları arasında bulunan yetersiz bellek hatası, PHP bellek sınırı artırılarak kolaylıkla çözülebilir: “WordPress Yetersiz Bellek Hatası ve Çözümü“
13. Yazı Editörü Beyaz Metin ve Eksik Düğmeler
Yazı yazmak için WordPress görsel editörünü açtınız ve ihtiyacınız olan araçların yerinde olmadığını fark ettiniz. Hatta görsel ve metin düzenleyici arasında geçiş de yapamıyorsunuz. Böyle bir durum söz konusu olduğunda içerik girmeniz ve düzenlemeniz zorlaşır. Merak etmeyin bu sorunu çözmek zor değil ve sorunun kaynağına bağlı olarak birkaç farklı çözüm yolu mevcut. İşte bu sorunu çözmenize yardımcı olabilecek kılavuz: “WordPress Görsel Editör Beyaz Metin ve Eksik Düğmeler Sorunu“
14. WordPress Mail Sorunu Çözümü
WordPress mail gönderme sorunu çoğu web site sahibinin karşılaştığı yaygın bir sorundur. WordPress ile e-posta göndermede sorun yaşıyorsanız bunun nedeni genellikle sunucu yapılandırmanızdaki sorunlardır. WordPress e-posta işlevi için PHP () posta işlevini kullanır. Bunu göz önünde bulundurarak, WordPress mail gönderme sorunu için aşağıdakiler sıralanabilir:
- Çoğu hosting firması, otomatik spam’i azaltmak için PHP Mail işlevine geçici veya kalıcı kısıtlamalar getirebilir.
- Bu işlev devre dışı bırakılmamış olsa bile web barındırıcınız, PHP Posta işlevi kullanılarak gönderilen e-postaları filtreliyor olabilir. Böylece, e-postalarınız gönderilir ancak alıcıya ulaşmaz ya da ulaşsa bile çoğu zaman spam olarak işaretlenir.
- Yanlış yapılandırmalar da bir diğer nedendir.
WordPress mail sorunu için kolay bir çözüm var. İşte çözüm kılavuzu: “WP Mail SMTP Ayarları/WordPress Mail Sorunu Çözümü“
15. ERR_TOO_MANY_REDIRECTS Hatası
Çoğu durumda, ERR_TOO_MANY_REDIRECTS sorunu yanlış yapılandırmadan kaynaklıdır. WordPress, URL’leri yeni gönderilerinize ve sayfalarınıza atadığında bir yeniden yönlendirme biçimi kullanır. Herhangi bir yanlış yapılandırma döngü etkisine neden olabilir. Yönlendirmeler SEO için sıklıkla kullanılır ve genel olarak kötü bir şey değildir. Yalnızca bir ‘yönlendirme döngüsünde’ birbirine işaret eden çok fazla yönlendirme olduğunda sorunlara neden olurlar. Bunun çözümü için detaylı kılavuzumuza bakabilirsiniz: WordPress ERR_TOO_MANY_REDIRECTS Hatası Çözümü.
16. Facebook Hatalı Küçük Resim Sorunu
Facebook ve diğer sosyal medya platformlarında paylaşılan içerik görselleri, etkileşimi artırmak ve sitenize yönlendirme trafiği almak için oldukça önemlidir. Görsel içeren gönderiler genellikle daha fazla tıklama ve paylaşım alır. Bu da, daha fazla kullanıcının sitenize geleceği ve ayrıca içeriğinizin daha fazla paylaşılacağı anlamına gelir. Ancak, bazı durumlarda Facebook’da yanlış/hatalı küçük resim sorunu ile karşılaşabilirsiniz. Bu sorun genellikle birkaç basit adımla aşılabilir. İşte neler yapılabileceğine dair bir kılavuz: WordPress’te Facebook Hatalı Küçük Resim Çözümü
17. Şifre Sıfırlama E-postası Gelmiyor
Bu hata WordPress’te çok yaygın bir sorundur. WordPress’in e-posta gönderme sistemi sorunlu olabilir.
- Spam klasörünüzü kontrol edin.
- E-posta adresinizin doğru yazıldığından emin olun.
- WP Mail SMTP gibi bir eklenti kurun.
- Hosting sağlayıcınızdan SMTP ayarlarını alın.
- WP Mail SMTP Ayarları/WordPress Mail Sorunu Çözümü kılavuzumuzdan faydalanın.
18. Sonsuz Yönlendirme Döngüsü
Giriş yaptığınızda sayfa sürekli yenileniyorsa, çerez problemi yaşıyor olabilirsiniz.
- Tarayıcı çerezlerini temizleyin.
- Farklı bir tarayıcıda deneyin.
- wp-config.php’ye
define('ADMIN_COOKIE_PATH', '/');satırını ekleyin. - Site URL’nizin doğruluğunu kontrol edin.
19. Dosya Boyutu Sınırı Aşımı
WordPress ve hosting sunucunuz, yüklenebilecek maksimum dosya boyutunu kısıtlar. Yönetim panelinde Medya → Yeni Ekle sayfasında maksimum yükleme boyutunu görebilirsiniz.
- Çözüm:
- php.ini dosyasını düzenleyin (
upload_max_filesize ve post_max_sizedeğerlerini artırın). - .htaccess dosyasına sınır artırma kodları ekleyin.
- wp-config.php’de @ini_set ile sınırları yükseltin.
- Detaylar için: WordPress Maksimum Yükleme Boyutu Nasıl Artırılır?
- php.ini dosyasını düzenleyin (
20. Bozuk veya Eksik Görseller
Yüklenen görseller sitede görünmüyor veya bozuk mu görünüyor? Bu genellikle dosya izinleri veya yanlış URL yapısından kaynaklanır.
- Çözüm:
- wp-content/uploads klasörünün izinlerini 755 yapın. (bkz: WordPress Dosya İzinleri Nasıl Değiştirilir?)
- Site URL’nizi Ayarlar → Genel’den kontrol edin. Her iki url’nin de doğru olduğundan emin olun.
- Regenerate Thumbnails eklentisini kullanın.
- CDN kullanıyorsanız ayarlarını gözden geçirin.
21. SSL Sertifikası ve Karışık İçerik Hataları
HTTPS’e geçiş yaptınız ama tarayıcıda “güvenli değil” uyarısı mı alıyorsunuz? Ya da bazı görseller ve dosyalar yüklenmiyor mu? Bu, “mixed content” yani karışık içerik hatası olarak bilinir. Siteniz HTTPS üzerinden çalışırken, bazı kaynaklar (görseller, scriptler, CSS dosyaları) hâlâ HTTP protokolü ile yükleniyor olabilir. Bu hem güvenlik açığı yaratır hem de kullanıcı deneyimini olumsuz etkiler. Bu sorun genellikle site taşıma veya SSL sertifikası kurulumu sonrasında ortaya çıkar. Veritabanında eski HTTP URL’leri kalmış olabilir veya tema/eklentiler sabit kodlanmış HTTP linkleri içeriyor olabilir.
- Adım Adım Çözüm:
- WordPress yönetim panelinde Ayarlar → Genel’e gidin. “WordPress Adresi (URL)” ve “Site Adresi (URL)” alanlarının ikisini de https:// ile başlayacak şekilde güncelleyin.
- Better Search Replace veya Velvet Blues Update URLs gibi eklentileri kullanarak veritabanındaki tüm eski HTTP linklerini HTTPS’ye çevirin. Manuel yapmak isterseniz phpMyAdmin’de SQL sorgusu çalıştırabilirsiniz.
- Tema veya eklenti dosyalarında sabit kodlanmış http:// linkleri olup olmadığını kontrol edin. Varsa bunları // (protocol-relative URL) veya https:// ile değiştirin.
- .htaccess dosyanıza HTTP’den HTTPS’ye otomatik yönlendirme kodu ekleyin. Böylece eski linkler otomatik olarak güvenli versiyona yönlendirilir.
22. Yavaş Site Hızı ve Performans Optimizasyonu
WordPress siteniz yavaş mı yükleniyor? Bu, hem kullanıcı deneyimini hem de SEO sıralamanızı olumsuz etkileyen kritik bir sorundur. Google, sayfa hızını sıralama faktörü olarak kullanır ve kullanıcılar 3 saniyeden uzun süre yüklenen siteleri terk eder. İyi haber şu ki, performans optimizasyonu karmaşık görünse de, birkaç basit adımla sitenizi önemli ölçüde hızlandırabilirsiniz.
- Cache eklentisi kullanın (ör. WP Rocket, LiteSpeed Cache, W3 Total Cache) — host ile uyumlu olanı seçin.
- Görselleri WebP veya optimize edilmiş JPEG/PNG yapın; boyutu küçültün.
- Gereksiz eklentileri kaldırın; E-Commerce gibi ağır işlevleri sadece gerekliyse kullanın.
- CDN kullanın (Cloudflare veya benzeri).
- CSS ve JavaScript’i Minimalize Edin
- Veritabanını Optimize Edin
