Node.js报错EADDRINUSE的端口占用解决方案

Node.js报错EADDRINUSE的端口占用解决方案

在Node.js开发过程中，EADDRINUSE错误是一种常见的端口占用错误，通常表示你尝试启动的服务器端口已经被其他进程占用。这类错误可能导致服务器无法正常启动，影响开发效率。本文结合CSDN技术社区的实战案例，详细分析EADDRINUSE错误的成因及解决方案，并提供丰富的代码示例和表格分析。

---

一、EADDRINUSE错误的常见成因

1. 端口被其他进程占用

• 错误示例：
  在启动Node.js服务器时，如果指定的端口（如3000）已被其他进程占用，会触发EADDRINUSE错误。
• 原因：
  其他程序或服务已经占用了该端口，导致当前Node.js应用无法绑定到该端口。

2. 进程未完全退出

• 错误示例：
  在开发过程中，如果之前的Node.js进程没有正确退出，可能会留下一个正在监听的套接字，导致新的进程无法绑定到相同的端口。
• 原因：
  进程未完全退出，导致端口仍然被占用。

3. Nodemon等工具导致的快速重启

• 错误示例：
  在使用Nodemon等工具进行开发时，如果保存文件过于频繁，可能会导致之前的进程尚未完全退出，新的进程又尝试绑定到相同的端口。
• 原因：
  快速重启导致端口占用冲突。

---

二、EADDRINUSE错误的解决方案

1. 查找并终止占用端口的进程

• Windows系统：
  使用命令行工具查找并终止占用端口的进程。

  # 查找占用端口的进程ID
  netstat -ano | findstr :3000
  # 终止进程（将12345替换为实际的进程ID）
  taskkill /PID 12345 /F
  

• Linux/macOS系统：
  使用命令行工具查找并终止占用端口的进程。

  # 查找占用端口的进程
  lsof -i :3000
  # 终止进程（将12345替换为实际的进程ID）
  kill 12345
  

• 作用：
  通过终止占用端口的进程，释放端口资源，使Node.js应用能够正常启动。

2. 更改Node.js应用的端口号

• 修复示例：
  在Node.js代码中，更改监听端口的那一行（通常是app.listen(port)或server.listen(port)），将端口号更改为其他未被占用的端口。

  const express = require('express');
  const app = express();
  const PORT = process.env.PORT || 3001; // 将端口号从3000更改为3001或其他未被占用的端口
  
  app.get('/', (req, res) => {
       
    res.send('Hello World!');
  });
  
  app.listen(PORT, () => {
       
    console.