Node应用如何解决EADDRINUSE端口占用 无需手动杀进程

不用每次手动执行lsof查进程再kill，几个成熟方案可以直接用，覆盖绝大多数开发场景：

1. 启动脚本预清理（最省事，零业务代码侵入） #

这个方案不用改任何业务逻辑，只需要调整启动命令，每次启动应用前自动清理目标端口的占用进程，跨平台支持Windows/macOS/Linux。

• 先安装轻量工具包作为开发依赖：
  npm install kill-port -D
• 修改package.json里的启动脚本，在原有启动命令前加端口清理逻辑：

{
  "scripts": {
    "start:express": "kill-port 3000 && node index.js",
    "start:react": "kill-port 3000 && react-scripts start",
    "dev": "kill-port 3000 && nodemon index.js"
  }
}

改完之后不管上次退出有没有残留僵尸进程，执行启动命令时都会先自动释放3000端口，不会再抛EADDRINUSE错误。

2. 代码层主动回收端口（从根源避免残留） #

如果是自己写的Express/Node服务，可以直接在入口代码里加两层逻辑：一是启动前检查端口占用自动释放，二是监听所有进程退出信号，主动关闭服务触发端口回收，哪怕异常退出也尽量避免留僵尸进程。
参考实现：

const express = require('express');
const net = require('net');
const killPort = require('kill-port');
const app = express();
const PORT = 3000;

// 检查端口是否被占用
const checkPortInUse = (port) => {
  return new Promise((resolve) => {
    const testServer = net.createServer();
    testServer.once('error', err => {
      resolve(err.code === 'EADDRINUSE');
    });
    testServer.once('listening', () => {
      testServer.close();
      resolve(false);
    });
    testServer.listen(port);
  });
};

// 启动服务
const startServer = async () => {
  const inUse = await checkPortInUse(PORT);
  if (inUse) {
    await killPort(PORT);
    console.log(`已自动清理${PORT}端口的残留进程`);
  }
  const server = app.listen(PORT, () => {
    console.log(`服务运行在 http://localhost:${PORT}`);
  });

  // 监听所有退出场景，主动关闭服务释放端口
  const shutdown = () => {
    server.close(() => process.exit(0));
    setTimeout(() => process.exit(1), 2000); // 超时强制退出
  };
  process.on('SIGINT', shutdown); // Ctrl+C退出
  process.on('SIGTERM', shutdown); // 终端关闭/进程被终止时触发
  process.on('exit', shutdown); // 进程正常退出时触发
};

startServer();

3. 开发工具自带配置适配 #

如果用nodemon、PM2这类进程管理工具跑开发环境服务，不需要额外装包，开对应配置就能自动处理端口占用：

• 用nodemon的话，启动命令加--signal SIGTERM参数，会在重启时主动给旧进程发终止信号，触发端口释放：
  nodemon --signal SIGTERM index.js
• 用PM2的话，在配置文件里开启wait_ready: true，同时在业务代码里监听SIGINT消息主动关闭服务即可。

补充：如果不想装任何依赖，macOS/Linux用户可以在自己的shell配置文件（.zshrc/.bashrc）里加个别名：
alias kp="lsof -ti:$1 | xargs kill -9"
遇到端口占用直接执行kp 3000就能一键杀对应端口进程，比手动敲两条命令省事，但还是不如上面的自动方案方便。

这个问题的本质是Node应用被强制关闭、异常崩溃时，没有走到正常的服务关闭逻辑，系统没来得及回收端口，导致残留僵尸进程占用端口，上面的方案要么在启动前兜底清理，要么在退出时主动触发回收，完全可以替代手动查进程杀进程的操作。

内容的提问来源于stack exchange，提问作者Catto