Node.js "EADDRINUSE" Hatası ve Çözümü: Sunucu Sorunlarınızı Çözün!

Hadi gelin, Node.js ile çalışırken karşılaştığınız en can sıkıcı hatalardan biri olan "EADDRINUSE" hatasını birlikte inceleyelim. Eğer daha önce bu hatayı gördüyseniz, hemen gözlerinizde o tanıdık korkuyu fark etmişsinizdir. Ama korkmayın, çünkü bu yazı sayesinde, bu hatanın ne olduğunu, neden oluştuğunu ve nasıl çözüleceğini öğrenmiş olacaksınız.

Node.js geliştirenler için oldukça tanıdık bir hata olan EADDRINUSE, genellikle bir sunucu başlatılmaya çalışıldığında ve belirli bir port zaten başka bir uygulama tarafından kullanıldığında meydana gelir. Düşünün ki, bir otobüs durağında yer bulamıyorsunuz, çünkü oradaki tüm koltuklar dolmuş. İşte bu hata da tam olarak bunun gibi, aynı portu birden fazla program kullanmaya çalıştığında Node.js, bu çakışmaya “EADDRINUSE” diyerek yanıt verir.

Bu hatayı gördüğünüzde, portunuzun başka bir uygulama tarafından işgal edilmiş olduğunu anlamalısınız. Yani, Node.js'iniz çalışmaya başlamadan önce, önceden o portu kullanan başka bir işlem var demektir.

Bazen, terminalde şu şekilde bir mesajla karşılaşabilirsiniz:

Error: listen EADDRINUSE 0.0.0.0:3000
    at Object._errnoException (util.js:1022:11)
    at _exceptionWithHostPort (util.js:1044:20)
    at Server.setupListenHandle [as _listen2] (net.js:1348:14)
    at listenInCluster (net.js:1395:12)
    at Server.listen (net.js:1481:7)
    at Object. (/path/to/your/app.js:10:5)
    at Module._compile (node:internal/modules/cjs/loader:1221:14)

Bu mesaj, Node.js'in belirttiğiniz portu (örneğin, 3000) kullanmak istediğini, ancak bu portun başka bir işlem tarafından zaten kullanıldığını gösteriyor.

EADDRINUSE hatasını çözmek oldukça basit. İşte adım adım çözüm önerileri:

Öncelikle, portu kullanan işlemi bulmamız gerekiyor. Eğer bir port numarasını biliyorsanız, aşağıdaki komut ile o portu kullanan işlemi bulabilirsiniz:

Windows:

netstat -ano | findstr :3000

Bu komut, 3000 numaralı portu kullanan işlemi gösterecektir.

Linux/Mac:

lsof -i :3000

Bu komut da aynı şekilde, belirtilen portu kullanan işlemi gösterecektir.

Portu kullanan işlemi öğrendikten sonra, bu işlemi sonlandırmamız gerekiyor. Eğer işlem bir Node.js uygulamasıysa, aşağıdaki komutla işlemi sonlandırabilirsiniz:

Windows:

taskkill /PID  /F

Linux/Mac:

kill -9 

Burada ``, önceki adımda öğrendiğiniz işlem numarasıdır. İşlemi sonlandırdığınızda, port serbest kalacaktır.

# 3. Uygulamanızı Yeniden Başlatmak

Artık portunuz serbest kaldığına göre, Node.js uygulamanızı yeniden başlatabilirsiniz. Bu sefer EADDRINUSE hatasını almazsınız, çünkü portu kullanmak için engel yok.

Diğer Çözümler

Eğer sıkça bu hatayı alıyorsanız ve her seferinde portu serbest bırakmakla uğraşmak istemiyorsanız, şu alternatif çözümleri de düşünebilirsiniz:

# 1. Farklı Bir Port Kullanmak

Uygulamanızda kullanılan portu değiştirmek, bu hatadan hızlıca kaçınmanıza yardımcı olabilir. İşte bir örnek:

const express = require('express');
const app = express();

// Portu değiştirelim
const port = process.env.PORT || 3001;

app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

Burada, port numarasını değiştirdik ve artık 3001 numaralı portu kullanacağız.

# 2. Portu Dinamik Olarak Kontrol Etmek

Bir başka seçenek de, portun kullanılabilirliğini kontrol edip, bir sorun olmadığından emin olarak uygulamanızı başlatmaktır. Aşağıda basit bir çözüm yer alıyor:

const net = require('net');
const port = 3000;

const server = net.createServer();

server.listen(port, () => {
  console.log(`Port ${port} is available and the server is running!`);
});

server.on('error', (err) => {
  if (err.code === 'EADDRINUSE') {
    console.log(`Port ${port} is already in use, trying a new port...`);
    server.listen(port + 1); // Yeni port denemesi
  }
});

Bu örnekte, eğer 3000 numaralı port kullanılabiliyorsa sunucu başlatılacak, eğer port kullanılıyorsa, bir sonraki port olan 3001 numarasına geçilecektir.

Sonuç

Artık EADDRINUSE hatasının ne olduğunu, nasıl ortaya çıktığını ve nasıl çözüleceğini biliyorsunuz! Node.js ile geliştirirken karşılaşabileceğiniz bu hatayı doğru bir şekilde tespit edip, basit birkaç adımda çözebilirsiniz. Unutmayın, her zaman portunuzu kontrol etmek ve gerektiğinde başka bir port kullanmak, sizi bu tip hatalardan kurtarabilir.

Umarım bu yazı sizin için faydalı olmuştur. Hadi, kodlarınıza geri dönün ve hatasız bir şekilde çalışmaya devam edin!