Site açılmıyor ve ekranda bir sayı var. Bu sayı aslında değerli bir ipucudur: sorunun hangi katmanda olduğunu söyler. Doğru okunduğunda teşhis süresini dakikalara indirir.
Bu rehber, hosting ortamında en sık karşılaşılan hata kodlarını ve her birinin gerçek anlamını açıklıyor.
Hızlı Bakış
| Kod | Anlamı | Sorun nerede? |
|---|---|---|
| 403 | Erişim reddedildi | İzinler veya erişim kuralları |
| 404 | Bulunamadı | Yol veya yönlendirme kuralları |
| 500 | Sunucu içi hata | Uygulama kodu veya yapılandırma |
| 502 | Geçersiz yanıt | Arka uç servisi çalışmıyor |
| 503 | Hizmet kullanılamıyor | Kaynak limiti veya bakım |
| 504 | Zaman aşımı | İşlem çok uzun sürüyor |
Temel ayrım şudur: 4 ile başlayanlar istemci tarafını, 5 ile başlayanlar sunucu tarafını işaret eder. Bu ayrım tek başına aramanızı yarıya indirir.
403: Erişim Reddedildi
Sunucu dosyayı buldu ama size vermeyi reddediyor. Hosting ortamında yaygın nedenleri:
- Dosya izinleri yanlış. Web sunucusu dosyayı okuyamıyor.
- Dizin listeleme kapalı ve index dosyası yok. Klasörde gösterilecek bir başlangıç dosyası bulunmuyor.
- Erişim kuralı engelliyor. Yapılandırma dosyanızda IP veya yol bazlı bir kısıt olabilir.
- Güvenlik modülü engelledi. Sunucudaki koruma katmanı isteği zararlı sandı.
Dördüncü madde e-ticaret ve form yoğun sitelerde sık yaşanır: normal bir işlem, güvenlik kuralına takılıp reddedilir. Bu durumda sağlayıcınızdan ilgili kuralın gevşetilmesini istemeniz gerekir.
404: Bulunamadı
Görünürde en basit hata ama iki farklı senaryosu vardır:
Tek sayfada 404: Bağlantı yanlış, sayfa silinmiş veya adresi değişmiş. Çözüm, doğru adrese kalıcı yönlendirme kurmaktır.
Tüm sayfalarda 404 ama ana sayfa açılıyor: Bu, yönlendirme kurallarının çalışmadığını gösterir. Ana sayfa gerçek bir dosya olduğu için açılır; diğer adresler ise kural üzerinden çözüldüğü için bulunamaz.
İkinci senaryonun nedeni genellikle yapılandırma dosyasının silinmesi, bozulması veya sunucuda ilgili modülün devre dışı olmasıdır.
500: Sunucu İçi Hata
En genel ve en az bilgi veren hatadır. "Bir şey ters gitti" demekten fazlasını söylemez. Hosting ortamında en yaygın nedenleri:
- Yapılandırma dosyasında sözdizimi hatası. Tek bir yanlış satır tüm siteyi kapatır.
- PHP ölümcül hatası. Eksik dosya, uyumsuz eklenti veya bellek sınırı aşımı.
- Yazma izni sorunu. Uygulama log veya önbellek dosyasına yazamıyor.
- Uyumsuz PHP sürümü. Yükseltme sonrası eski kod çalışmaz hâle gelmiş olabilir.
500 hatasında yapılacak ilk iş hata logunu okumaktır. Log, tahmin yürütmeyi gereksiz kılan tek satırı içerir: hangi dosyanın hangi satırında ne olduğunu söyler.
502, 503 ve 504: Üç Kardeş
502 — Geçersiz Yanıt
Web sunucusu, PHP işlemcisine bağlanmayı denedi ama düzgün bir yanıt alamadı. Genellikle arka uç servisi çökmüş veya yeniden başlatılıyordur. Kısa süreli 502'ler bir yeniden başlatma anına denk gelmiş olabilir.
503 — Hizmet Kullanılamıyor
Paylaşımlı hostingde bunun en yaygın anlamı kaynak limitinize takıldığınızdır. Eşzamanlı işlem sayınız kotanızı aşmıştır ve yeni istekler reddedilmektedir.
Trafik artışı, bir bot taraması veya ağır bir zamanlanmış görev bunu tetikleyebilir. Sürekli yaşanıyorsa paket kapasitesi yetersiz demektir.
504 — Zaman Aşımı
İşlem başladı ama makul sürede bitmedi. Uzun süren bir sorgu, yavaş bir dış API çağrısı veya ağır bir toplu işlem tipik nedenlerdir.
Teşhis Sırası
- Kodu not edin. Tarayıcının gösterdiği sayı ilk ipucudur.
- Hata logunu açın. Panelde hata logu bölümü, çoğu sorunda doğrudan cevabı verir.
- Son değişikliği düşünün. Eklenti mi güncellendi, PHP sürümü mü değişti, yapılandırma mı düzenlendi?
- Değişikliği geri alın. Yeni çözüm denemeden önce çalışan duruma dönün.
- Tek tek devre dışı bırakın. Neden bulunamıyorsa eklentileri kapatıp teker teker açın.
İkinci adım en çok atlanandır. Kullanıcıların büyük kısmı logu hiç açmadan tahmin yürütmeye başlar — oysa cevap orada yazılıdır.
Önleyici Önlemler
- Değişiklik yapmadan önce yedek alın
- Yapılandırma dosyasını düzenlemeden önce kopyalayın
- PHP sürümü yükseltmesini önce test ortamında deneyin
- Özel 404 sayfası tanımlayın — ziyaretçi kaybetmeyin
- Siteyi dışarıdan izleyin; kesintiyi müşteriden önce siz öğrenin
Sürekli 503 alıyorsanız sorun yapılandırma değil kapasitedir. Bu durumda daha yüksek kaynak limiti sunan bir hosting paketine geçmek, her seferinde limit aşımını beklemekten daha sağlıklı bir çözümdür.
Sonuç
Hata kodu bir engel değil, ipucudur. 4'lü kodlar istek tarafını, 5'li kodlar sunucu tarafını gösterir. 403 izin, 404 yol, 500 uygulama, 502 arka uç servisi, 503 kaynak limiti ve 504 süre sorunudur. Hangi kodu görürseniz görün ilk adım aynıdır: hata logunu açın. Loga bakmadan yapılan her tahmin, zaten yazılı olan cevabı aramakla geçen zamandır.
Sıkça Sorulan Sorular (SSS)
500 hatası alıyorum ama nedenini göremiyorum, ne yapmalıyım?
Hata logunu okuyun — panelde hata logu bölümünde hangi dosyanın hangi satırında sorun olduğu yazar. Gerekirse PHP hata görüntülemeyi geçici olarak açıp ekranda detayı görebilirsiniz, ancak sorunu çözdükten sonra mutlaka kapatın.
Ana sayfa açılıyor ama diğer sayfalar 404 veriyor?
Yönlendirme kuralları çalışmıyor demektir. Ana sayfa gerçek bir dosya olduğu için açılır; diğer adresler kural üzerinden çözüldüğü için bulunamaz. Yapılandırma dosyanızın yerinde ve doğru olduğunu kontrol edin.
Sürekli 503 alıyorum, ne anlama geliyor?
Paylaşımlı hostingde bu genellikle kaynak limitine takıldığınızı gösterir — eşzamanlı işlem sayınız kotanızı aşıyor. Geçici bir trafik artışı olabilir, ancak sürekli yaşanıyorsa paketiniz mevcut trafiğiniz için yetersizdir.
502 hatası geçici mi kalıcı mı?
Kısa süreli 502'ler genellikle arka uç servisinin yeniden başlatıldığı ana denk gelir ve kendiliğinden düzelir. Kalıcıysa PHP işlemcisi çalışmıyor demektir; sağlayıcınıza bildirin.
