EADDRINUSE错误表示端口被占用，需先用netstat或lsof查PID，再用taskkill或kill终止进程；也可修改app.listen端口、用PORT环境变量动态配置，或清理nodemon残留进程。
如果您尝试启动Node.js项目时遇到EADDRINUSE错误，提示端口已被占用，则说明目标端口正被其他进程使用。以下是解决此问题的步骤：
一、查找占用指定端口的进程
通过系统命令定位当前占用端口的具体进程ID（PID），从而判断是否为误占或可终止进程。
1、在终端中执行命令：netstat -ano | findstr :3000（将3000替换为您实际报错的端口号）
2、若系统为macOS或Linux，执行：lsof -i :3000
3、记录输出结果中显示的PID（Windows下为最后一列数字，macOS/Linux下为COMMAND前的数字）
二、终止占用端口的进程
获取PID后，可直接结束该进程以释放端口，确保Node.js服务能正常绑定。
1、Windows系统执行：taskkill /PID 12345 /F（将12345替换为实际查到的PID）
2、macOS或Linux系统执行：kill -9 12345
3、验证端口是否已释放：再次运行查找命令，确认无输出结果
三、修改Node.js项目监听端口
若无法终止原进程或需避免冲突，可临时更改应用监听端口，绕过占用问题。
1、打开项目入口文件（如app.js、server.js或index.js）
2、查找类似app.listen(3000)或server.listen(3000)的语句
3、将端口号改为未被占用的值，例如app.listen(<strong><font color="green">3001</font></strong>)
四、使用环境变量动态指定端口
通过环境变量控制监听端口，提升配置灵活性并便于多环境部署。
1、在启动脚本中设置环境变量：export PORT=3002（macOS/Linux）或 set PORT=3002（Windows）
2、修改代码中监听逻辑为：app.listen(process.env.PORT || 3000)
3、重启项目，此时将优先使用环境变量设定的端口
五、检查开发服务器自动重启残留进程
使用nodemon等热重载工具时，异常退出可能导致旧进程未彻底关闭，持续占用端口。
1、执行ps aux | grep node（macOS/Linux）或 tasklist | findstr node（Windows）
2、识别名称含nodemon、node server.js等的多余进程及其PID
3、对每个可疑PID重复执行终止命令，确保无残留node实例运行
