HTTP 500 Internal Server Error — Nedenleri ve Çözümleri

HTTP 500 ne anlama gelir

HTTP 500 Internal Server Error, genel "bizim tarafımızda bir şeyler ters gitti" yanıtıdır. İstek uygulamaya ulaştı, uygulama başarısız oldu — işlenmemiş bir istisna, bir yanlış yapılandırma, ölü bir bağımlılık — ve sunucunun söyleyecek daha iyi bir şeyi yoktu.

Ziyaretçiler için bir 500 onların hatası değildir ve tarayıcıdan nadiren düzeltilebilir. Geliştiriciler için her zaman sunucu tarafında bir günlük kaydına karşılık gelir; çözüm o yığın izini (stack trace) bulmakla başlar.

500 hatalarının yaygın nedenleri

Uygulama kodunda işlenmemiş bir istisna (boş referanslar, tip hataları, başarısız doğrulamalar).
Yanlış yapılandırma: bozuk .htaccess veya nginx yönergeleri, yanlış dosya izinleri, eksik ortam değişkenleri.
Ölü veya zaman aşımına uğrayan bir bağımlılık: veritabanı çökmüş, göçler (migration) eksik, geri dönüş (fallback) olmadan başarısız olan harici API.
Kaynak tükenmesi: bellek yetersizliği, PHP/worker sınırları, dolu disk.
Kötü bir dağıtım: eksik paketler, uyumsuz kütüphane sürümleri, üretim kodunda sözdizimi hataları.

Bir ziyaretçi olarak nasıl düzeltilir

Kısa bir bekleme sonrası bir kez yeniden yükleyin — birçok 500, geçici dağıtım veya aşırı yük sıçramasıdır.
Daha sonra tekrar gelin; sitenin ekibi genellikle siz onlara söyleyemeden önce bilir.
Yalnızca hata özellikle sizde devam ediyor ve başkalarında değilse çerezleri temizleyin.

Bir geliştirici olarak nasıl düzeltilir

Sunucu hata günlüğünü okuyun — yığın izi cevaptır (nginx/apache hata günlüğü, uygulama günlüğü, APM).
Hatalar onunla başladıysa önce en son dağıtımı geri alın.
Erişim günlüklerinden tam olarak başarısız olan isteği yeniden üretin; hiç yoksa hata izleme (Sentry vb.) ekleyin.
Üretimde kullanıcılara asla yığın izlerini göstermeyin — ayrıntıları günlükleyin, dostane bir sayfa gösterin.

Örnek yanıt

HTTP/1.1 500 Internal Server Error
Content-Type: text/html

<!doctype html>
<title>Something went wrong</title>

SEO etkisi

Sürekli 500'ler arama motorlarının taramasını yavaşlatır ve haftalarca sürerse etkilenen URL'leri dizinden düşürebilir. Kısa süreli olaylar zararsızdır — Google herhangi bir karar vermeden önce yeniden dener.

SSS

Bir 500 hatası ziyaretçi olarak benim hatam mı?

Hayır. Bu bir sunucu tarafı hatasıdır. Bekleyip yeniden yüklemek yapabileceğiniz hemen hemen tek şeydir.

Bir 500'e neyin sebep olduğunu nerede bulurum?

Sunucunun hata günlüğünde veya hata izleme hizmetinizde — her 500, kaydedilmiş bir istisna veya yapılandırma hatasına karşılık gelir.

500 hataları SEO'yu etkiler mi?

Kısa kesintiler zarar vermez. Günlerce veya haftalarca süren 500'ler taramayı azaltır ve sayfaları geçici olarak dizinden düşürebilir.