WordPress Güncelleme Takılı Kaldı: Beyaz Ekran Çözümü

WordPress güncelleme sırasında beyaz ekran ya da takılma sorunu yaşıyorsanız, .maintenance dosyasını silmek ve WP-CLI kullanmak sorunu çözer.

WordPress Güncelleme Neden Takılır?

WordPress güncellemesi sırasında "Güncelleniyor... Lütfen sayfayı yenilemeyin." mesajında takılı kalmak ya da güncelleme sonrası beyaz ekranla karşılaşmak son derece yaygın bir sorundur. Bu sorun panik yaratsa da çoğu durumda kolayca çözülebilir.

WordPress, güncelleme başladığında kök dizinde otomatik olarak .maintenance adlı gizli bir dosya oluşturur. Bu dosya mevcutken siteye giren ziyaretçiler "Briefly unavailable for scheduled maintenance" (Planlı bakım için kısa süreliğine kullanılamıyor) mesajını görür. Güncelleme başarıyla tamamlanırsa bu dosya otomatik silinir. Ancak güncelleme yarıda kesilirse dosya yerinde kalır ve site sürekli bu mesajı gösterir.

Belirtiler

• Site ana sayfası beyaz ekran gösteriyor
• "Briefly unavailable for scheduled maintenance" mesajı
• Admin paneli (wp-admin) açılmıyor
• Güncelleme %100 tamamlanıp tekrar güncelleme ekranı çıkıyor
• Fatal error mesajları

Çözüm 1: .maintenance Dosyasını Silme

En yaygın çözüm yöntemidir. WordPress kök dizininde bulunan gizli .maintenance dosyasını silmeniz yeterlidir.

FTP/SFTP ile

FileZilla veya WinSCP gibi bir FTP istemcisi kullanarak siteye bağlanın. Gizli dosyaları görmek için "Sunucu → Gizli dosyaları göster" seçeneğini aktifleştirin. WordPress kök dizininde .maintenance dosyasını bulun ve silin.

SSH ile

# WordPress kök dizinine git
cd /var/www/html/wordpress

# .maintenance dosyasını listele
ls -la | grep .maintenance

# Dosyayı sil
rm .maintenance

cPanel Dosya Yöneticisi ile

cPanel'e giriş yapın → Dosya Yöneticisi → WordPress kök dizinine gidin → Sağ üst köşeden "Gizli Dosyaları Göster" seçeneğini aktifleştirin → .maintenance dosyasını bulup silin.

Çözüm 2: WP-CLI ile Güncelleme

WP-CLI, WordPress'i komut satırından yönetmenizi sağlayan resmi araçtır. GUI üzerinden takılan güncellemeler WP-CLI ile sorunsuz tamamlanabilir:

# WP-CLI kurulumu (eğer yoksa)
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

# WordPress kök dizinine git
cd /var/www/html/wordpress

# WordPress çekirdeğini güncelle
wp core update --allow-root

# Tüm eklentileri güncelle
wp plugin update --all --allow-root

# Tüm temaları güncelle
wp theme update --all --allow-root

# Veritabanını güncelle
wp core update-db --allow-root

Çözüm 3: Manuel Güncelleme (FTP ile)

GUI üzerinden güncelleme sürekli başarısız oluyorsa manuel yöntem daha güvenilirdir:

1. WordPress.org'dan en güncel sürümü indirin
2. ZIP dosyasını bilgisayarınızda açın
3. FTP ile sunucuya bağlanın
4. wp-admin ve wp-includes klasörlerini sunucudaki ile değiştirin
5. Kök dizindeki PHP dosyalarını güncelleyin (wp-config.php'ye dokunmayın)
6. Tarayıcıda https://siteniz.com/wp-admin/upgrade.php adresini açın

Çözüm 4: Beyaz Ekran (WSOD) Giderme

Güncelleme sonrası beyaz ekran (White Screen of Death) ile karşılaşıyorsanız:

WP_DEBUG Aktifleştirme

sudo nano /var/www/html/wordpress/wp-config.php

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

Ardından wp-content/debug.log dosyasını inceleyin:

tail -50 /var/www/html/wordpress/wp-content/debug.log

Eklentileri Devre Dışı Bırakma

# WP-CLI ile tüm eklentileri devre dışı bırak
wp plugin deactivate --all --allow-root

# Sonra tek tek aktifleştirerek sorunu bul
wp plugin activate plugin-name --allow-root

FTP erişiminiz varsa, wp-content/plugins klasörünü geçici olarak plugins_disabled olarak yeniden adlandırabilirsiniz. WordPress eklentileri bulamazsa hepsini otomatik devre dışı bırakır.

Temayı Varsayılana Döndürme

wp theme activate twentytwentyfour --allow-root

Çözüm 5: PHP Bellek Limitini Artırma

Güncelleme sırasında PHP bellek limiti aşılırsa beyaz ekran oluşur. wp-config.php'ye şunu ekleyin:

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

Çözüm 6: Veritabanı Tablosunu Kontrol Etme

Güncelleme bazen veritabanı tablolarını bozabilir:

wp db check --allow-root
wp db repair --allow-root

Otomatik Güncellemeyi Devre Dışı Bırakma

Bu tür sorunları yaşamamak için bazı kullanıcılar otomatik güncellemeleri kapatmayı tercih eder. Ancak bu güvenlik açısından risklidir. Alternatif olarak güncelleme öncesi her zaman yedek alın:

# Güncelleme öncesi yedek al
wp db export backup-$(date +%Y%m%d).sql --allow-root

Önleyici Tedbirler

• Her güncelleme öncesinde tam site yedeği alın (UpdraftPlus veya BlogVault)
• Önce bir test ortamında (staging) güncelleyin
• PHP ve MySQL sürümlerinin WordPress gereksinimleriyle uyumlu olduğundan emin olun
• Eklenti ve tema sayısını minimumda tutun
• WP-CLI ile komut satırından güncelleme yapın (daha güvenilirdir)

Özet

WordPress güncelleme takılması sorununun %90'ı .maintenance dosyasını silmekle çözülür. Beyaz ekran durumunda WP_DEBUG aktifleştirip hata loglarını inceleyin, eklentileri devre dışı bırakın ve WP-CLI ile güncellemeyi tamamlayın. En önemlisi: her zaman güncelleme öncesinde yedek alın.

Yorumlar

Henüz yorum yok. İlk yorumu siz yapın!