ECONNREFUSED, ETIMEDOUT, ECONNRESET: Hata Kodları Arasındaki Fark

Sunucu izleme aracı bir uyarı gönderdiğinde, "site çöktü" diye hemen her şeyi yeniden başlatmak yerine hata koduna bakmak lazım. ECONNREFUSED, ETIMEDOUT ve ECONNRESET birbirinden tamamen farklı problemleri işaret ediyor.

ECONNREFUSED en basit olanı: hedef port açık değil. Servis çalışmıyor, firewall engellemiş veya yanlış porta bağlanmaya çalışıyorsun. Sunucunun kendisine sorun yok, bağlantı kurulmadan reddediliyor.

ETIMEDOUT ise bağlantı kurulmaya çalışılıyor ama yanıt gelmiyor. Ağ gecikme, sunucu donmuş, CPU'su %100 kapalı veya paket kaybı söz konusu. İstek gidiyor ama cevap dönmüyor. Zaman aşımı süresi bitince hata alıyorsun.

ECONNRESET en sinir bozucu olanı: bağlantı kurulmuş, veri alışverişi başlamış, sonra karşı taraf bağlantıyı aniden kesiyor. Sunucu crash olmuş, proxy sıkıştı, veya firewall mid-stream'de bağlantıyı keserken yakalandı. Kısaca: "başladı ama yarıda kaldı".

Node.js ile hızlıca test edebilirsin. Kaynak linkteki kod örneğini çalıştırıp üç hatayı da yerel ortamda tetikle. Üretimde bu kodları görürsen, her birinin çözümü farklı: REFUSED servisi başlat, TIMEOUT performans/ağ kontrol et, RESET sunucu günlükleri ve crash raporlarına bak.

3 sabah çağrısında değerli 20 dakika kazandıracak bilgi budur.