401, 403, 404 ve 500 ne demek? HTTP hata kodları

Bir sayfa açılmayınca her sorunu “internet bozuk” diye düşünmek çözümü zorlaştırır. HTTP durum kodu, isteğe sunucunun nasıl yanıt verdiğine dair bir ipucudur. Kod tek başına bütün nedeni anlatmaz; istek adresi, yöntem ve sunucu kaydıyla birlikte okunur.

Önce neyi çözmek istediğini belirle

Bir isteğin sonucunu durum koduyla sınıflandırıp rastgele değişiklik yapmak yerine araştıracağımız katmanı belirleyeceğiz. fetch ağ hatası ile HTTP hata yanıtını farklı ele alır.

Adım adım uygula

1 İsteği bul. Tarayıcının Network panelini aç, hatayı tekrar üret ve ilgili satırı seç. Sadece konsol mesajına bakmak yerine URL ve yöntemi kontrol et.
2 Sınıfını ayır. 2xx başarı, 3xx yönlendirme, 4xx istemci isteğiyle ilgili durumlar, 5xx sunucu tarafı sorunları gösterir. 404 bulunamadı; 401 kimlik doğrulama, 403 yetkiyle ilgilidir.
3 Doğru yeri düzelt. 404 için dosya yolu veya rota; 401 için oturum; 403 için izin; 500 için sunucu kayıtlarını incele. Kullanıcıya gereksiz ayrıntı ve sır gösterme.

Küçük bir örnek

JavaScript

async function getir() {
  const yanit = await fetch("/veri.json");
  if (!yanit.ok) throw new Error(`HTTP ${yanit.status}`);
  return yanit.json();
}

Sık takılınan nokta

fetch 404 yanıtında otomatik olarak catch’e atlamaz. response.ok veya status kontrolü gerekir. CORS hatası görünüyorsa güvenlik ayarlarını kapatmak yerine isteğin kaynağını ve sunucu izinlerini incele.

Şimdi kendin dene

Yerel sunucunda var olmayan bir JSON dosyasına istek gönder. Network’te 404 satırını bul; sonra doğru dosyaya geçip başarı durumunu karşılaştır.

Bir sonraki adım Hata türleri, düzeltme ve kontrol örnekleri →

En Sık Karşılaşılan HTTP Durum Kodları ve Hızlı Teşhis Tablosu

Kod	Adı	Sorunun Kaynağı	Anlamı	İlk Kontrol Edilecek Yer
200 / 201	OK / Created	Başarılı	İstek başarıyla işlendi veya yeni kayıt oluşturuldu	Yanıt gövdesindeki (JSON/HTML) veriyi doğrula
301 / 302	Moved Permanently / Found	Yönlendirme	Sayfa kalıcı veya geçici olarak başka bir URL'ye taşındı	`Location` başlığını ve sonsuz yönlendirme döngüsünü kontrol et
400	Bad Request	İstemci (Tarayıcı/Kod)	Gönderilen JSON, form verisi veya parametre biçimi hatalı	Network sekmesinde gönderilen Payload ve zorunlu alanları incele
401	Unauthorized	İstemci Kimliği	Oturum açılmamış veya gönderilen Token/API anahtarı geçersiz	`Authorization: Bearer ` başlığını ve token süresini kontrol et
403	Forbidden	Yetki / İzin	Kimlik biliniyor ancak bu kaynağa erişim yetkisi yok	Kullanıcı rolünü, CORS ayarlarını veya dosya okuma izinlerini denetle
404	Not Found	Adres / Rota	İstenen URL veya dosya sunucuda mevcut değil	Dosya yolundaki büyük/küçük harf uyumunu ve API endpoint adresini kontrol et
429	Too Many Requests	Hız Sınırı	Kısa sürede çok fazla istek gönderildi (Rate Limit)	İstek sıklığını azalt, önbellekleme (cache) veya bekleme süresi ekle
500 / 502 / 503	Server Error / Bad Gateway	Sunucu / Backend	Sunucu kodunda yakalanmamış hata veya arka uç servisi kapalı	Sunucu hata kayıtlarını (error logs) ve veritabanı bağlantısını incele

Gerçek Hayatta Karar Verme ve Uygulama Senaryoları

401 ile 403 arasındaki farkı karıştırmamak: 401 'Sen kimsin bilmiyorum, önce giriş yap' demektir; 403 ise 'Senin kim olduğunu biliyorum ama bu yönetici sayfasına girmeye yetkin yok' anlamına gelir.
Tarayıcı Geliştirici Araçları (F12 → Network) ile teşhis: Sayfada bir veri yüklenmediğinde F12 tuşuna basıp Network (Ağ) sekmesini aç; kırmızı görünen satıra tıklayarak hem Status kodunu hem de sunucunun döndürdüğü Response mesajını oku.

Sıkça Sorulan Sorular (SSS)

500 Internal Server Error hatasını tarayıcıdan çözebilir miyim? +

Eğer sitenin ziyaretçisiysen 500 hatası sunucu tarafındadır; senin tarayıcınla ilgili değildir. Ancak sitenin geliştiricisiysen backend konsolundaki stack trace (hata izi) çıktısına bakarak hangi satırda istisna fırlatıldığını bulmalısın.

404 hatası SEO'yu olumsuz etkiler mi? +

Silinmiş veya adresi değişmiş önemli sayfaların 404 döndürmesi ziyaretçi kaybına yol açar. Taşınan sayfaları 301 yönlendirmesiyle yeni adresine bağlamak en doğru yaklaşımdır.

Kaynak ve devamı

Resmi belgeleri aç ↗