Node.js+Express使用nodemon重启报EADDRINUSE端口占用，杀进程无效怎么办

核心报错本质 #

你启动服务时抛出的异常提示如下：

Error: listen EADDRINUSE: address already in use 3111;
这类报错并不是一定有明确的后台进程抢占端口，结合你排查时找不到对应node进程、清理命令无匹配结果的情况，问题通常来自两个方向：

• TCP端口处于TIME_WAIT状态：之前启动的Node服务被强制终止后，TCP连接不会立刻释放端口，需要等待2MSL（通常30秒到2分钟）的系统回收周期，这段时间内端口会被系统标记为不可用，新服务启动就会触发占用报错。
• Nodemon残留子进程异常持锁：使用npx nodemon启动服务时，如果进程异常中断，nodemon的后台守护进程会悄悄持有之前拉起的node子进程的端口监听，这类进程因为权限/进程树归属的问题，普通的killall -9 node命令无法识别匹配，导致端口一直被隐形占用。

分步排查解决操作 #

1. 精准定位端口实际占用源 #

替换之前的排查命令，全量列出和目标端口关联的所有状态条目：

• 执行 sudo lsof -nP -iTCP:3111 -sTCP:LISTEN，过滤出所有处于监听状态、持有3111端口的进程，拿到对应PID后执行 sudo kill -9 <查到的PID> 强制终止即可。
• 执行 netstat -anv | grep 3111，可以同时看到处于TIME_WAIT、LISTEN状态的端口条目，确认端口是否在系统的回收等待周期内。

2. 调整服务代码逻辑，从根源避免端口无法释放 #

修改服务监听部分的代码，增加端口快速复用能力和优雅退出逻辑，替换原来的服务启动代码：

// 原有其他代码保持不变...

// 替换原来的app.listen部分
const server = app.listen(process.env.PORT || 3111, () => {
  console.log("Server launched");
});

// 配置端口快速复用，跳过TIME_WAIT等待周期
server.on('listening', () => {
  server._handle._reusePort = true;
});

// 监听系统退出信号，主动释放端口
process.on('SIGTERM', () => {
  server.close(() => {
    process.exit(0);
  });
});
process.on('SIGINT', () => {
  server.close(() => {
    process.exit(0);
  });
});

3. 优化Nodemon启动参数，避免残留进程 #

普通的nodemon启动方式很容易出现异常残留，调整启动流程：

• 先清理所有之前残留的nodemon进程，执行 pkill -f nodemon
• 启动时增加--signal SIGTERM参数，让nodemon重启服务时，给旧进程发送正常退出信号，而不是直接强制终止，保证端口能被正常释放，对应启动命令为：
  npx nodemon --signal SIGTERM index.js

临时快速规避方案 #

如果不想等待端口回收，也不手动反复换端口，可以把监听的端口号改为0，启动时系统会自动分配一个当前无占用的随机可用端口，控制台打印的启动回调里可以直接获取实际分配的端口号。

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