Fehler beheben: 'listen EADDRINUSE: address already in use' in Node.js

Der gefürchtete EADDRINUSE-Fehler tritt auf, wenn man ihn am wenigsten erwartet. Sie sind bereit, Ihren Node.js-Server zu starten, aber statt einer laufenden Anwendung erhalten Sie: Error: listen EADDRINUSE: address already in use :::3000. Dieser Node.js EADDRINUSE-Fehler bedeutet, dass ein anderer Prozess bereits den Port verwendet, an den Sie binden möchten. Hier erfahren Sie, wie Sie diesen Portkonflikt in Node.js schnell identifizieren und beheben können.

Was verursacht den EADDRINUSE-Fehler?

Der listen EADDRINUSE-Fehler tritt auf, wenn Ihre Node.js-Anwendung versucht, sich an einen bereits belegten Port zu binden. Häufige Ursachen sind:

• Eine vorherige Instanz Ihres Servers läuft noch
• Eine andere Anwendung verwendet denselben Port
• Zombie-Prozesse von abgestürzten Node.js-Apps
• Hot-Reload-Tools wie nodemon räumen nicht ordnungsgemäß auf
• Integrierte IDE-Terminals halten Prozesse am Leben

So finden Sie heraus, welcher Prozess den Port verwendet

Bevor Sie den belegten Port freigeben können, müssen Sie identifizieren, was ihn verwendet. Die Befehle unterscheiden sich je nach Betriebssystem.

macOS und Linux

Verwenden Sie lsof, um den Prozess zu finden:

lsof -i :3000

Dies gibt Prozessdetails einschließlich der PID (Prozess-ID) zurück:

COMMAND   PID    USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
node     12345   you   11u  IPv6 0xac745b2749fd2be3      0t0  TCP *:3000 (LISTEN)

Windows

Verwenden Sie netstat, um den Prozess zu identifizieren:

netstat -ano | findstr :3000

Die Ausgabe zeigt die PID in der letzten Spalte:

TCP    0.0.0.0:3000    0.0.0.0:0    LISTENING    12345

So beenden Sie den Prozess und geben den Port frei

Sobald Sie die PID haben, können Sie den Prozess beenden, um den Port freizugeben.

Lösungen für macOS und Linux

Schneller Einzeiler:

lsof -ti:3000 | xargs kill -9

Manueller Ansatz:

kill -15 12345  # Ordnungsgemäßes Herunterfahren (bevorzugt)
kill -9 12345   # Erzwungenes Beenden, falls -15 nicht funktioniert

Alternative mit fuser:

sudo fuser -k 3000/tcp

Windows-Lösungen

Eingabeaufforderung:

taskkill /PID 12345 /F

PowerShell:

Stop-Process -Id 12345 -Force

GUI-Methode: Öffnen Sie den Task-Manager (Strg+Umschalt+Esc), finden Sie den Node.js-Prozess und beenden Sie ihn.

Zukünftige Portkonflikte verhindern

Ordnungsgemäßes Herunterfahren implementieren

Fügen Sie Ihrem Node.js-Server geeignete Cleanup-Handler hinzu, um Portfehler zu vermeiden:

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

// Handle termination signals
process.on('SIGTERM', () => {
  server.close(() => {
    console.log('Server closed gracefully');
    process.exit(0);
  });
});

process.on('SIGINT', () => {
  server.close(() => {
    console.log('Server closed gracefully');
    process.exit(0);
  });
});

Dynamische Portwahl verwenden

Vermeiden Sie fest codierte Ports. Verwenden Sie Umgebungsvariablen oder finden Sie automatisch einen verfügbaren Port:

const PORT = process.env.PORT || 3000;

// Or check port availability before binding
const net = require('net');

function getAvailablePort(startPort) {
  return new Promise((resolve) => {
    const server = net.createServer();
    server.listen(startPort, () => {
      const port = server.address().port;
      server.close(() => resolve(port));
    });
    server.on('error', () => {
      getAvailablePort(startPort + 1).then(resolve);
    });
  });
}

Fehler programmatisch behandeln

Fangen Sie den Fehler ab und reagieren Sie entsprechend:

server.on('error', (err) => {
  if (err.code === 'EADDRINUSE') {
    console.error(`Port ${PORT} is already in use`);
    // Try another port or exit gracefully
    process.exit(1);
  }
});

Häufige Szenarien und schnelle Lösungen

Nodemon gibt Ports nicht frei

Wenn Sie nodemon verwenden, stellen Sie sicher, dass Sie es mit Strg+C stoppen, nicht mit Strg+Z. Letzteres unterbricht den Prozess, ohne den Port freizugeben.

Docker-Container-Konflikte

Prüfen Sie auf laufende Container:

docker ps
docker stop <container_id>

VS Code Terminal-Probleme

Schließen Sie alle integrierten Terminals, bevor Sie Ihren Server neu starten. Manchmal hält VS Code Prozesse im Hintergrund am Leben.

Mehrere Server-Instanzen im Code

Stellen Sie sicher, dass Sie app.listen() nicht mehrmals in Ihrer Codebasis aufrufen. Dieser häufige Fehler löst den address already in use-Fehler sofort aus.

Fazit

Der Node.js EADDRINUSE-Fehler ist frustrierend, aber leicht zu beheben. Finden Sie den Prozess, der Ihren Port verwendet, mit lsof oder netstat, beenden Sie ihn und implementieren Sie geeignete Shutdown-Handler, um zukünftige Vorkommnisse zu verhindern. Denken Sie daran: Ordnungsgemäßes Herunterfahren mit Signal-Handlern und dynamische Portwahl ersparen Ihnen, sich wiederholt mit diesem Node.js-Server-Portfehler auseinandersetzen zu müssen.

Häufig gestellte Fragen (FAQs)

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers. Check our GitHub repo and join the thousands of developers in our community.