WordPress Hataları: Neden Olur, Nasıl Çözülür?
Error establishing a database connection
This either means that the username and password information in your wp-config.php file is incorrect or that contact with the database server at localhost could not be established.
- Are you sure you have the correct username and password?
- Are you sure you have typed the correct hostname?
Bu Rehberde Ne Öğreneceksin?
Bu rehberin sonunda, ekranda beliren o korkutucu WordPress hatalarının aslında ne anlama geldiğini ve siteni tamamen bozmadan bu sorunları kendi başına nasıl çözeceğini öğrenmiş olacaksın. Hazırsan başlayalım.
WordPress Hataları Nedir?
Siten bir anda beyaz bir ekrana dönüştü veya ekranda anlamadığın İngilizce yazılar belirdi. Derin bir nefes al, siten silinmedi.
WordPress dünyada en çok kullanılan sistemdir. Ancak çok fazla eklenti (siteye form, galeri gibi özellikler katan küçük dosyalar) ve tema (sitenin dış görünüşünü belirleyen şablonlar) barındırdığı için bazen bu parçalar birbiriyle anlaşamaz. Bu anlaşmazlık ekrana bir "hata kodu" olarak yansır. Aslında bu hatalar, sistemin sana "burada bir tıkanıklık var, lütfen düzelt" deme şeklidir.
WordPress hataları; sitenin dosyaları, sunucusu (dosyaların barındığı bilgisayar) veya veritabanı (yazıların ve ayarların tutulduğu depo) arasındaki iletişimin anlık olarak kopması veya bozulması sonucu ortaya çıkan teknik güvenlik uyarılarıdır.
Eski Yöntem vs. Güncel Yaklaşım
- ❌ Hata görünce sitenin hacklendiğini sanıp her şeyi silmek.
- ❌ Hangi eklentinin sorunu yarattığını bilmeden rastgele dosya silmek.
- ❌ İnternette bulduğu her kod parçasını kopyalayıp siteye yapıştırmak.
- ✅ Önce sorunun kaynağını bulmak için hata ayıklama modunu açmak.
- ✅ Dosyalara müdahale etmeden önce mutlaka güncel bir yedek almak.
- ✅ Sorunu eklenti, tema ve sunucu üçgeninde sırayla test etmek.
Bilmen Gereken Terimler
Basitçe açıklıyoruz, ezberlemene gerek yok.
Bilgisayarındaki dosyaları internetteki siteye atmanı sağlayan köprü programı.
Sitenin e-posta, veritabanı ve dosyalarını yönettiğin ana kontrol paneli.
Sitenin beyni sayılan, şifrelerin ve ana ayarların tutulduğu en kritik dosya.
Tüm yazıların, ürünlerin ve ayarların metin olarak saklandığı veritabanı deposu.
Sitenin trafik kurallarını ve link yapılarını yöneten görünmez dosya.
Site hızlı açılsın diye sayfaların dondurulmuş (önbelleğe alınmış) hali.
Sunucunun senin sitene ayırdığı anlık işlem yapma gücü (RAM).
WordPress'in çalışmasını sağlayan temel iskelet dosyaları.
En Sık Karşılaşılan WordPress Hataları
1. Beyaz Ekran Hatası (WSOD - White Screen of Death)
Siteye girmeye çalıştığında karşına hiçbir hata mesajı olmayan, bomboş, bembeyaz bir sayfa çıkar. Genelde sitenin yönetici paneline (wp-admin) de giremezsin.
Bu hata, sitendeki bir kodun (genelde yeni yüklediğin bir eklenti veya temanın) kendi içinde sonsuz bir döngüye girmesi veya sunucunun işlem hafızasını tüketmesi sonucu oluşur. Sistem sana yanlış bir şey göstermektense ekranı tamamen kapatmayı seçer.
⚠️ Dikkat
Beyaz ekran hatası alıyorsan asla siteni tamamen sıfırlamaya kalkma. Sitenin içeriği tamamen güvendedir, sadece ekrana yansımasını engelleyen küçük bir kod pürüzü vardır.
2. Veritabanı Bağlantı Hatası
Ekranda İngilizce olarak "Error establishing a database connection" yazar. Bu, WordPress dosyalarının senin içerik depona (veritabanına) ulaşamadığı anlamına gelir.
WordPress bir vitrin, veritabanı ise o vitrini dolduran depodur. Sitenin dosyaları, bu depoya girmek için bir kullanıcı adı ve şifreye ihtiyaç duyar. Eğer veritabanı bağlantı bilgilerinde (wp-config.php dosyasının içinde) tek bir harf bile değiştiyse veya sunucun anlık olarak çöktüyse bu hatayı alırsın.
3. 500 Internal Server Error (İç Sunucu Hatası)
Bu, sunucunun (siteni barındıran bilgisayarın) kafasının karıştığını gösteren genel bir koddur. Neden bozulduğunu tam olarak söylemez.
Genelde iki sebebi vardır: Ya temanın içindeki bir kod yanlıştır ya da .htaccess (sitenin trafik kurallarını belirleyen dosya) içinde bir yazım hatası yapılmıştır.
💡 İpucu
Bir hata almadan hemen önce hangi eklentiyi yüklediğini veya hangi ayarı değiştirdiğini hatırlamaya çalış. Çözümün %90'ı, yaptığın en son işlemi geri almaktan geçer.
4. 404 Sayfa Bulunamadı Hatası
Sitenin ana sayfası sorunsuz açılır ama yazılara veya ürünlere tıkladığında "Sayfa Bulunamadı" (404) hatası alırsın.
Bu durum yazılarının silindiği anlamına gelmez. Sadece kalıcı bağlantıların (URL adres yapısı) bozulmuştur. WordPress yolunu kaybetmiştir. Çözümü çok basittir, WordPress paneline girip ayarları bir kez kaydetmek yeterlidir.
Site hızlandırma (cache) eklentileri bazen sitenin hatalı halini dondurup kaydeder. Sen sorunu çözsen bile hata görmeye devam edersin. Hata çözerken her zaman tarayıcının gizli sekmesini kullan.
Adım Adım Hata Çözme Rehberi
Ekranda bir hata gördüğünde sırasıyla uygulaman gereken adımlar.
Hata Ayıklama (Debug) Modunu Aç
Ekranda sadece beyaz bir boşluk veya anlamsız bir "500 hatası" varsa, WordPress'in sana asıl sorunu söylemesini sağlamalısın. Cpanel (sunucu kontrol panelin) veya FTP üzerinden sitene bağlan.
Ana dizindeki wp-config.php dosyasını aç ve "WP_DEBUG" yazan satırı bulup "false" kelimesini "true" yap. Sayfayı yenilediğinde sana hatanın hangi dosyadan kaynaklandığını açıkça söyleyecektir.
define( 'WP_DEBUG', true );
// Disable WP_DEBUG mode (Eski Hali)
define( 'WP_DEBUG', false );
Tüm Eklentileri Devre Dışı Bırak
Hataların %90'ı eklentilerin birbiriyle çakışmasından çıkar. Yönetim paneline (wp-admin) giremiyorsan eklentileri dosyalar üzerinden kapatman gerekir.
Yine dosyalarına gir. wp-content klasörünün içindeki plugins klasörünün adını sağ tıklayıp plugins_eski olarak değiştir. Bu hamle, sitendeki tüm eklentileri anında durdurur. Site açıldıysa, sorun bir eklentidedir. Klasör adını düzeltip paneline gir ve eklentileri tek tek aktif ederek suçluyu bul.
Kalıcı Bağlantıları Yenile (.htaccess)
Eğer 404 hataları veya yönlendirme sorunları yaşıyorsan, sitenin trafik polisi olan .htaccess dosyası bozulmuştur.
WordPress paneline girebiliyorsan "Ayarlar > Kalıcı Bağlantılar" sayfasına git. Hiçbir şeyi değiştirmeden doğrudan "Değişiklikleri Kaydet" butonuna bas. Bu basit hareket, .htaccess dosyasını sıfırdan ve hatasız bir şekilde yeniden oluşturur.
Sadece bu butona basmak, dosyanı yeniler.
Buraya kadar geldiysen temel sorunları çözme mantığını kavradın. Ama bu noktadan sonra sunucunun bellek sınırları, veritabanı tabloları ve çekirdek dosyalar devreye giriyor. Yanlış bir tabloyu silmek, siteni geri dönülmez şekilde bozabilir. Eğer kendini rahat hissetmiyorsan, risk almadan destek almanın tam zamanıdır.
PHP Bellek Limitini (Memory Limit) Artır
Özellikle "Allowed memory size exhausted" şeklinde bir uyarı alıyorsan, siten sunucunun ona ayırdığı gücü aşmış demektir. Bu genelde büyük resimler yüklerken veya ağır bir eklenti çalışırken olur.
Yine wp-config.php dosyanı aç ve uygun bir satıra bellek limitini artıran kodu ekle. Bu, sitene "daha fazla RAM kullanabilirsin" demektir.
define( 'WP_MEMORY_LIMIT', '256M' );
"Hataların %90'ı, sitene eklediğin en son eklentinin veya temanın, sistemin eski parçalarıyla kavga etmesinden kaynaklanır. Bir şeyler bozulduğunda her zaman geriye doğru düşün: 'En son neyi değiştirdim?'"
Sık Sorulan Sorular
WordPress beyaz ekran hatası (WSOD) neden olur? ↓
Genellikle bozuk bir eklenti, hatalı kodlanmış bir tema veya yetersiz PHP bellek limiti (RAM) nedeniyle olur. Hata ayıklama (debug) modunu açarak hatanın tam yerini görebilirsin.
Veritabanı bağlantı hatasını nasıl düzeltebilirim? ↓
Ana dizindeki wp-config.php dosyasını açıp içindeki veritabanı adı (DB_NAME), kullanıcı adı (DB_USER) ve şifre (DB_PASSWORD) kısımlarının, hosting (sunucu) panelindeki bilgilerle birebir eşleştiğinden emin olmalısın.
Panele (wp-admin) giremiyorum, eklentileri nasıl silebilirim? ↓
Hosting paneline (cPanel vb.) veya FTP programına giriş yap. Dosya yöneticisinden wp-content klasörüne gir. Oradaki plugins klasörünün ismini plugins_kapatildi gibi başka bir şeye çevir. Bu, hepsini devre dışı bırakır ve panele girmene izin verir.
500 Internal Server Error ne demek? ↓
Sunucu tabanlı genel bir hatadır. Çoğunlukla bozuk bir .htaccess dosyasından veya sunucudaki dosya izinlerinin (CHMOD) yanlış ayarlanmasından kaynaklanır. .htaccess dosyasının ismini değiştirerek sorunun kaynağını test edebilirsin.
Siteyi güncellerken "Bakım Modunda Kaldı" hatası alıyorum, ne yapmalıyım? ↓
Güncelleme yarıda kesildiğinde WordPress sitede kilitli kalır. FTP veya dosya yöneticisiyle sitenin ana dizinine (wp-config.php'nin olduğu yer) bağlan ve orada gizli olan .maintenance isimli dosyayı sil. Siten anında geri gelecektir.
403 Forbidden hatası nedir? ↓
Sunucunun, senin o sayfayı görmene yetkin olmadığını söylemesidir. Genelde bir güvenlik eklentisinin seni engellemesi veya sunucudaki klasör izinlerinin (klasörler 755, dosyalar 644 olmalıdır) yanlış ayarlanmasından kaynaklanır.
Yaptığım değişiklikler sitede neden görünmüyor? ↓
Bu bir hata değil, önbellek (cache) durumudur. Siteni hızlandıran eklenti, sayfanın eski halini hafızada tutuyordur. Cache eklentinden "Önbelleği Temizle" seçeneğine tıklamalısın veya tarayıcını gizli sekmede açmalısın.
WordPress dosyalarını silsen site tamamen yok olur mu? ↓
Dosyaları silersen sitenin tasarımı ve çalışma iskeleti gider. Ancak yazıların, sayfaların ve ayarların veritabanında güvendedir. Veritabanı silinmediği sürece site (doğru dosyalar tekrar yüklenerek) kurtarılabilir.
Eklenti yüklerken "Hedef klasör zaten mevcut" uyarısı alıyorum? ↓
Daha önce aynı eklentiyi yüklemişsin ama silerken dosyaları tam temizlenmemiş. FTP'den wp-content/plugins içine girip, yüklemeye çalıştığın eklentinin adını taşıyan eski klasörü manuel olarak silmelisin.
Sürekli hata alan siteyi düzeltmek için kime başvurmalıyım? ↓
Sorun sunucu taraflıysa hosting firmanın destek ekibine yazmalısın. Eğer sorun kod veya yapılandırma kaynaklıysa profesyonel bir uzmandan destek alman site güvenliği için daha sağlıklı olacaktır.
Desteğe mi İhtiyacın Var? Buradayım.
Buraya kadar okuduysan konuyu artık biliyorsun. Uygulamaya geçerken takılırsan veya sitenin kodlarıyla oynamak riskli geliyorsa, birlikte çözelim.
Gökhan Vatancı ile Görüş →
Bir Yanıt
Kaliteli bir içerik teşekkürler Gökhan hocam