Node.js重启本地服务时报ERR_SERVER_ALREADY_LISTEN错误,是否进程未正常关闭?
问题原因排查
你遇到的这个报错,核心对应两种触发场景,结合你“改完代码重跑才触发报错”的描述来看,90%的概率是之前的Node进程没有完全退出,还在后台占用你要监听的本地端口,并不是你用Ctrl+C停止程序的方式本身有误。
- 端口被占场景:Windows环境下偶尔会出现终端焦点偏移、运行权限不匹配的情况,哪怕你按了Ctrl+C,主终端窗口关了,Node的后台子进程没跟着被正常回收,一直占着绑定的localhost端口,新启动的程序自然没法重复绑定同一个端口。
- 代码逻辑问题:极少数情况是代码里重复调用了两次
server.listen()方法,但这种情况不管你怎么重启程序都会报错,和你当前的场景不匹配。
Windows环境下清理残留进程的操作
- 快速处理:直接打开任务管理器,切换到「详细信息」标签,找到所有名称为
node.exe的进程,右键选择「结束任务」全部关闭,再重新启动程序即可。如果还有其他正在运行的Node项目,不想全部误关,就用精准定位法处理。 - 精准定位清理:
- 打开PowerShell或命令提示符,执行命令
netstat -ano | findstr "你服务实际监听的端口号",比如你的服务用的3000端口,就替换成3000 - 命令输出结果的最后一列数字,就是占用这个端口的进程PID
- 执行
taskkill /PID 刚才查到的PID数值 /F,就能强制终止占端口的残留进程,不会影响其他正常运行的项目
- 打开PowerShell或命令提示符,执行命令
后续避免残留的小技巧
如果你的服务逻辑比较复杂,可以在代码里加一段终止信号监听逻辑,收到Ctrl+C的终止指令时主动释放端口,避免进程残留:
process.on('SIGINT', () => { server.close(() => { process.exit(0) }) })
内容的提问来源于stack exchange,提问作者HoneyPoop
相关产品推荐
相关产品推荐

