WordPress’te Alınan Tüm Hatalar ve Çözümleri [2025 Mega Rehber]

WordPress, dünyanın en popüler içerik yönetim sistemi olabilir ama “hatasız” bir sistem asla değildir.
Çoğu zaman küçük bir kod, bozuk bir eklenti ya da yanlış bir ayar, tüm sitenin çökmesine neden olabilir.

Bu rehberde:

✅ En sık karşılaşılan hatalar
✅ Gelişmiş hata türleri (White screen, cron, cache, REST API, .htaccess)
✅ WordPress’e özel hata kodları
✅ Konsol hataları + çözümleri
✅ WooCommerce’e özel hatalar
✅ functions.php ile müdahale çözümleri
✅ Hosting tabanlı çözümler

…hepsi tek tek açıklanıyor. Hazırsan başlayalım!

🛠️ 1. Beyaz Ekran Hatası (White Screen of Death)

❗ Hata:

Siteye veya admin panele girdiğinde sadece beyaz ekran görünür. Hiçbir hata mesajı yoktur.

📌 Nedenleri:

• PHP belleği yetersiz
• Eklenti/tema çakışması
• Kod hatası (functions.php vs.)

✅ Çözüm:

1. wp-config.php içine hata ayıklama kodu ekle:

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

2. error_log dosyasına bak
3. wp-content/plugins klasörünü geçici olarak yeniden adlandır
4. functions.php dosyasını kontrol et (bozuk bir } bile beyaz ekran yapar)

🧩 2. “There has been a critical error on this website” Hatası

❗ Hata:

Sitede kritik bir hata oluştu, ekran bu uyarıyla kilitlenir.

✅ Çözüm:

• FTP ile error_log dosyasını indir
• Gelişmiş hata detaylarını görmek için mail adresini wp-config.php dosyasına tanımla

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

→ Genelde son yüklenen eklenti/tema kaynaklı olur.

📂 3. Eklenti/Temalar Yönetilemiyor, Site Açılmıyor

❗ Hata:

Yeni tema/eklenti yükledikten sonra siteye erişim tamamen gidiyor.

✅ Çözüm:

1. FTP → wp-content/plugins/ → Son yüklediğin eklentiyi sil
2. FTP → wp-content/themes/ → Son yüklediğin temayı sil
3. functions.php içine aşağıdaki kodu geçici olarak ekle:

switch_theme('twentytwentyfour');

🔐 4. Admin Şifresi Unutuldu / Şifre Değişmiyor

✅ Çözüm Yolları:

A. Veritabanı Üzerinden:

• wp_users tablosunu aç
• user_pass alanına şu şekilde MD5 şifre yaz:

UPDATE wp_users SET user_pass = MD5('yenisifre123') WHERE user_login = 'admin';

B. functions.php ile:

wp_set_password('yenisifre123', 1);

🔁 5. Yönlendirme Döngüsü (Too Many Redirects)

❗ Hata:

Site hiç açılmadan tarayıcı “çok fazla yönlendirme yapıldı” hatası verir.

✅ Çözüm:

• .htaccess dosyasını sıfırla:

# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress

• wp-config.php kontrol et:

define('WP_HOME','https://seninsite.com');
define('WP_SITEURL','https://seninsite.com');

🌐 6. SSL Sertifikası Aktif Ama Site “Güvenli Değil” Diyor

✅ Çözüm:

• WordPress → Ayarlar → Genel → http → https yap
• Really Simple SSL eklentisi ile tüm bağlantıları HTTPS zorla
• Tarayıcı konsolunda “mixed content” varsa, eski HTTP görselleri güncelle (Search & Replace ile)

🧮 7. Memory Limit (Allowed memory size of X bytes exhausted)

✅ Çözüm:

• wp-config.php içerisine şunu ekle:

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

• php.ini varsa:

memory_limit = 256M

🧱 8. .htaccess Kayboldu veya Bozuldu

❗ Etkisi:

• Sayfalar 404 hatası verir
• Permalinkler çalışmaz

✅ Çözüm:

• Ayarlar → Kalıcı bağlantılar → “Yazı ismi” → Kaydet
  → Bu işlem yeni .htaccess dosyası oluşturur.

📡 9. REST API Hatası (WordPress Site Sağlığı Uyarısı)

❗ Hata:

“REST API düzgün çalışmıyor” veya “loopback isteği başarısız oldu”

✅ Çözüm:

• mod_security aktifse hostingden kapat
• firewall veya Cloudflare API isteklerini engelliyorsa düzenle
• wp-json bağlantısı çalışıyor mu kontrol et

🔄 10. Otomatik Güncellemeler Çalışmıyor

❗ Hata:

Eklenti güncellemeleri veya WordPress versiyonu otomatik güncellenmiyor.

✅ Çözüm:

• wp-config.php kontrol et:

define('AUTOMATIC_UPDATER_DISABLED', false);
define('WP_AUTO_UPDATE_CORE', true);

🔐 11. “403 Forbidden” Hatası

❗ Sebepler:

• Güvenlik eklentisi yanlış kural yazmış
• .htaccess hatalı
• Hosting firması dosya izinlerini engelliyor

✅ Çözüm:

• wp-content klasörü: 755
• wp-config.php dosyası: 644
• .htaccess geçici olarak yeniden adlandır
• WAF (web application firewall) varsa geçici olarak kapat

🚫 12. “500 Internal Server Error”

✅ Çözüm:

1. .htaccess dosyasını sil
2. php.ini → memory_limit değerini artır
3. functions.php, eklenti dosyaları hatalı mı kontrol et
4. Hosting log dosyalarını incele

🛒 13. WooCommerce Hataları

🧾 Sepet çalışmıyor:

• woocommerce_cart_hash, woocommerce_items_in_cart çerezleri devre dışıysa
  → Tarayıcı çerezlerini kontrol et, optimize eklentisi engellemesin

🛍️ Ürün eklenmiyor:

• Ajax sorunu varsa admin-ajax.php çağrısı engellenmiş olabilir
• Tema dosyası woocommerce_template_loop_add_to_cart() fonksiyonunu barındırmalı

🧠 14. Geliştirici Dostu Bonus Hatalar

❌ Konsolda “jQuery is not defined”:

• JS dosyaları doğru sırada çağrılmamış
• wp_enqueue_script('jquery') eksik

❌ Konsolda “Failed to load resource”:

• CDN bağlantısı kopmuş olabilir
• Dosya yolları // ile başlıyorsa HTTPS ile çağır

⚙️ 15. PHP Versiyon Uyumsuzlukları

❗ Hata:

Bazı eklentiler ya da temalar yüklenemiyor, beyaz ekran oluşuyor veya “fatal error” hatası alınıyor.

✅ Çözüm:

• Hosting panelinden PHP 8.1 veya 8.2’ye geçiş yap
• WordPress 6.4 ve sonrası için minimum önerilen: PHP 8.1
• Eski eklentileri güncelle, kullanılmayanları sil
• error_log dosyasından hatalı fonksiyonu tespit et

🕓 16. WP-Cron İşlemleri Çalışmıyor / Gecikiyor

❗ Etkisi:

• Planlanan içerikler yayınlanmıyor
• Otomatik görevler (örneğin Woo fatura, rapor, sipariş iptali) tetiklenmiyor

✅ Çözüm:

• wp-config.php içine:

define('DISABLE_WP_CRON', true);

• Gerçek cron tanımı:

*/15 * * * * wget -q -O - https://seninsite.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

• WP Crontrol eklentisiyle cron işleri izlenebilir

📡 17. API Bağlantı Hataları (cURL / HTTP) – wp_remote_get çalışmıyor

❗ Hata:

wp_remote_get() veya wp_remote_post() fonksiyonları boş veri döndürür veya “couldn’t connect” hatası verir.

✅ Çözüm:

• Hosting’de cURL aktif mi kontrol et
• Güvenlik duvarı (mod_security) API adresini engelliyor olabilir
• Kullanılan API SSL sertifikasına sahip mi? (Bazı ücretsiz sertifikaları WordPress cURL engelleyebilir)
• wp-config.php içine geçici olarak:

add_filter('https_ssl_verify', '__return_false');

🔐 18. WordPress Güvenlik Duvarı / Firewall Kaynaklı Erişim Sorunları

❗ Hata:

• Bazı sayfalar açılmıyor
• /wp-admin/ erişilemiyor
• Sık sık “403 Forbidden” uyarısı geliyor

✅ Çözüm:

• Wordfence gibi eklentilerin güvenlik ayarlarını kontrol et
• Hosting üzerinden mod_security geçici olarak devre dışı bırak
• .htaccess dosyasında şu kısımları yorum satırına al:

# <IfModule mod_security.c>
# SecFilterEngine Off
# SecFilterScanPOST Off
# </IfModule>

📁 19. Dosya İzinleri Hataları

❗ Hata:

• Medya yüklenemiyor
• Temalar güncellenemiyor
• FTP veya dosya yöneticisi üzerinden erişim sınırlı

✅ İzinler:

• Klasörler: 755
• Dosyalar: 644
• wp-config.php: 440 veya 400
• uploads, cache, upgrade klasörlerinin yazılabilir olduğuna emin ol

📤 20. SMTP Hataları (Mail Gönderilmiyor)

❗ Hata:

• Formlar mail atmıyor
• Sipariş onayları gelmiyor
• “SMTP connect() failed” hatası

✅ Çözüm:

• WP Mail SMTP eklentisini kur
• Gmail SMTP → smtp.gmail.com / 587 TLS
• Hosting SMTP → mail.seninhostingin.com / 465 SSL
• SPF + DKIM kayıtlarını DNS’e tanımla
• wp_mail() çalışıyor mu test et

🌐 21. CDN / Cache Çakışması (Cloudflare, WP Rocket, LS Cache)

❗ Hata:

• CSS bozuk yükleniyor
• JS çalışmıyor
• Admin panelde değişiklikler görünmüyor

✅ Çözüm:

• Cloudflare > Geliştirici Modu’nu etkinleştir
• WP Rocket veya LiteSpeed Cache’de “Admin Panel Cacheleme” kapat
• Sayfa düzeyinde no-cache başlığı ekle:

header("Cache-Control: no-cache, must-revalidate");

🔁 22. WooCommerce Cron Tetiklenmemesi

❗ Hata:

• Ürün stokları güncellenmiyor
• Abonelik sistemleri çalışmıyor
• “WooCommerce Subscriptions” zamanlayıcıları aksıyor

✅ Çözüm:

• WP Crontrol eklentisi ile “wc_” ile başlayan cron işlerini kontrol et
• Tetiklenmeyen görev varsa action_scheduler tablosunu sıfırla

🧱 23. Veritabanı Bozulması / wp_options Şişmesi

❗ Hata:

• Site yavaşlar
• Ayarlar çalışmaz
• 500 hatası alırsın

✅ Çözüm:

• wp_options tablosunda autoload='yes' olan gereksiz verileri temizle
• transients geçici verilerini sil:

DELETE FROM wp_options WHERE option_name LIKE '_transient_%';

• WP Optimize ile tablo bakımı yap

📦 24. Tema Fonksiyonları Çakışıyor / functions.php ölüm tuzağı

❗ Hata:

• Küçük bir kod ekledikten sonra site tamamen çöküyor

✅ Çözüm:

• FTP ile eriş → son eklenen kodu sil
• Kodun sonuna ; eklemeyi unutma
• Eklenen fonksiyon varsa, if ( ! function_exists() ) ile sarmala

🔄 25. WordPress Güncelleme Sorunları (Failed to update / Briefly unavailable)

❗ Hata:

• Güncelleme yarım kalır
• “Briefly unavailable for scheduled maintenance” ekranı görünür

✅ Çözüm:

• FTP üzerinden .maintenance dosyasını sil
• Eklenti/tema güncellemeleri manuel yap
• wp-config.php → FS_METHOD belirleyerek update sorununu çöz:

define('FS_METHOD', 'direct');

🔚 Sonuç: Bu Noktadan Sonrası Uzman Seviyesi!

Bu bölümle birlikte artık sadece bir WordPress kullanıcısı değil, sistemini tanıyan, okuyan, analiz edebilen bir geliştirici veya teknik uzman oldun.