Sık görülen WordPress hatalarını düzeltin

WordPress hata verdiğinde ekrandaki mesaj yalnızca bir ipucudur. Gerçek neden, genellikle bir eklenti, bir tema, veritabanı ayarları veya bir PHP sınırı, bir kayda yazılır. Bu rehber kaydı nasıl okuyacağınızı ve en sık görülen hataları nasıl düzelteceğinizi gösterir.

1. adım: Hata ayıklama kaydını açın

wp-config.php dosyasını açın ve bu satırları /* That's all, stop editing! Happy publishing. */ satırının üstüne ekleyin. WP_DEBUG zaten tanımlıysa ikinci bir satır eklemek yerine o satırı değiştirin.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Hatalı sayfayı yeniden yükleyin, ardından wp-content/debug.log dosyasını açın. En yeni satırlar sondadır. wp-content/plugins/example-plugin/ veya wp-content/themes/example-theme/ gibi bir yol, sorunlu eklentiyi veya temayı gösterir.

"There has been a critical error on this website"

WordPress bir PHP ölümcül hatası yakaladı ve sitenin yönetici adresine kurtarma modu (recovery mode) bağlantısı içeren bir e-posta gönderir.

1. E-postadaki bağlantıyı açın ve giriş yapın. WordPress hata veren eklentiyi veya temayı yalnızca sizin tarayıcınız için duraklatır ve bir bildirimde adını gösterir.
2. O eklentiyi devre dışı bırakın (veya başka bir temaya geçin), ardından güncelleyin ya da değiştirin.
3. Yönetici çubuğundaki düğmeyle kurtarma modundan çıkın.

Doğrulama: site, gizli bir tarayıcı penceresinde ziyaretçiler için açılır. E-posta gelmediyse 1. adımdaki hata ayıklama kaydı dosyayı adıyla gösterir.

Beyaz ekran veya yönetim paneline ulaşamıyorsunuz

1. wp-content içinde plugins klasörünün adını plugins_old yapın. WordPress böylece eklentisiz çalışır.
2. Site şimdi çalışıyorsa klasörün adını yeniden plugins yapın, ardından siteyi bozanı bulana kadar eklenti klasörlerini tek tek yeniden adlandırın (örneğin example-plugin → example-plugin.off).
3. Site hâlâ beyazsa wp-content/themes içinde etkin temanın klasörünü yeniden adlandırın. Kuruluysa WordPress, Twenty Twenty-Five gibi varsayılan bir temaya geçer.

Doğrulama: yönetim paneli açılır. Plugins altında diğer eklentileri tek tek yeniden etkinleştirin.

"Error establishing a database connection"

WordPress veritabanına bağlanamıyor. Genellikle wp-config.php içindeki dört ayardan biri yanlıştır:

define( 'DB_NAME', 'database_name_here' );
define( 'DB_USER', 'username_here' );
define( 'DB_PASSWORD', 'password_here' );
define( 'DB_HOST', 'localhost' );

1. Panelinizde veritabanı adını ve veritabanı kullanıcısını DB_NAME ve DB_USER ile karşılaştırın. cPanel'de ikisi de ön ek olarak hesap adınızı taşır, örneğin account_wp1.
2. Kullanıcının o veritabanına tüm yetkilerle atandığını kontrol edin.
3. Şifreden emin değilseniz panelde veritabanı kullanıcısı için yeni bir şifre belirleyin ve onu DB_PASSWORD değerine yazın.

Bkz. veritabanları ve phpMyAdmin. Dört ayar da doğruysa ve hata sürüyorsa bir destek talebi açın.

"Briefly unavailable for scheduled maintenance. Check back in a minute."

Bir güncelleme bitmeden durdu ve .maintenance dosyasını geride bıraktı. WordPress kök klasöründeki .maintenance dosyasını silin (görmek için File Manager'da gizli dosyaları açın), ardından güncellemeyi Dashboard › Updates altında yeniden çalıştırın.

"Allowed memory size of … bytes exhausted"

Bir eklenti veya tema izin verilenden fazla PHP belleğine ihtiyaç duyuyor.

1. Panelinizde site için memory_limit değerini artırın; bkz. PHP sürümü ve ayarları. WordPress, PHP sınırı kendi ayarından yüksekse PHP sınırını korur; bu nedenle genellikle yalnızca bu yeterlidir.
2. wp-config.php dosyası WP_MEMORY_LIMIT tanımlıyorsa veya bir eklenti bunu ayarlamanızı istiyorsa, "stop editing" satırının üstünde PHP memory_limit değerinizden yüksek olmayan bir değer kullanın:

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

Daha fazla bellekle hata geri gelirse hata ayıklama kaydında adı geçen eklentide bir sorun vardır; güncelleyin veya değiştirin.

Yazılar ve sayfalar 404 hatası veriyor

Settings › Permalinks'i açın ve hiçbir şeyi değiştirmeden Save Changes'e tıklayın. WordPress yeniden yazma kurallarını yeniden yazar. İşe yaramazsa WordPress kök klasöründeki .htaccess dosyasının şu bloğu içerdiğini kontrol edin:

# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress

Site adresini değiştirdikten sonra yönlendirme döngüsü

Settings › General altındaki adresleri değiştirdiyseniz ve artık giriş yapamıyorsanız, onları wp-config.php içinde ayarlayın. Bu satırlar veritabanındaki değerleri geçersiz kılar:

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

İkisinde de aynı https:// adresini kullanın ve önce sertifikanın etkin olduğundan emin olun; bkz. ücretsiz SSL'i açma ve HTTPS'e zorlama.

Zaman aşımları ve yavaş yönetim sayfaları

Ağır eklentiler sunucudan paketinizin izin verdiğinden fazlasını isteyebilir. İhtiyacınız olmayan eklentileri devre dışı bırakın, test için varsayılan bir temaya geçin ve önbelleği açın; bkz. LiteSpeed Cache. 508 hataları için bkz. 500, 403, 404 ve 508 hatalarını düzeltme.

Sonraki adımlar

• Bir sonraki sorunu önleyin: WordPress sitesini güvenli hale getirme.
• Büyük güncellemelerden önce: hosting hesabınızı yedekleme ve geri yükleme.