先确认不是代码问题
服务重启后立刻退出,终端打出 Error: listen EADDRINUSE: address already in use :::3000。EADDRINUSE 是内核拒绝了 bind 请求,意思是这个端口已经有进程在监听,既不是权限不足,也不是语法错误,改代码不会有用。常见来源有三个:上一次的 node 进程没退干净,pm2 或者 systemd 拉起了两份实例,同一台机器上另一个项目默认也用 3000 端口。
ss -lntp | grep 3000
lsof -i :3000
netstat -ano | findstr :3000
按 PID 判断该不该杀
Linux 下 ss 输出的最后一列会带上进程名和 pid,Windows 的 netstat 只给 pid,还得用 tasklist 反查镜像名。确认占用者是 node、npm 或 pm2 守护进程,直接结束即可;如果占的是 nginx、java、redis 或者数据库,先停手,这通常说明端口规划撞车了,应该改自己的监听端口,而不是去杀别人的服务。结束进程优先用 SIGTERM,让程序走完关闭流程,连接池和临时文件能正常回收,实在不退再补一刀 SIGKILL。
kill -15 4812
taskkill /PID 4812 /F
tasklist | findstr 4812
换端口要同步改反代
不方便动别人的进程,就用环境变量覆盖监听端口。看起来服务已经起来了,但页面还是 502,多半是 Nginx 的 upstream 仍指向 3000。改完端口后重新加载 Nginx,再确认新端口处于 LISTEN 状态,接口才算真正可用。
PORT=3100 node server.js
nginx -t && nginx -s reload
curl -I http://127.0.0.1:3100/health
反复出现就是有东西在自动拉起
杀掉之后几分钟又报同样的错,说明进程被守护程序重新启动了。pm2 list 里检查有没有同名应用重复注册,docker run 的 -p 3000:3000 映射在容器存活期间会一直占着端口,容器不删端口就不会释放。更稳妥的做法是在启动脚本里先做一次端口探测,被占用就直接退出并打印提示,让部署在第一步失败,而不是跑到一半才发现接口起不来。
