eaddrinuse 错误表示端口被占用，需先用netstat（windows）或lsof（macos/linux）查pid，再用taskkill/kill终止进程；也可通过npm start -- --port 3001、port=3001 npm start或修改代码为process.env.port || 3001实现端口切换。
如果您执行 npm start 后遇到 EADDRINUSE 错误，提示类似 address already in use :::3000，则说明 Node.js 应用尝试绑定的端口正被系统中另一个进程占用。以下是解决此问题的步骤：
一、查找占用指定端口的进程
通过系统命令定位当前占用目标端口的进程 ID（PID），从而确认是否为残留服务或可安全终止的实例。
1、Windows 系统中，在命令提示符或 PowerShell 中运行：netstat -ano | findstr :3000（将 3000 替换为实际报错端口号）
2、macOS 或 Linux 系统中，在终端中运行：lsof -i :3000
3、记录输出结果中显示的 PID 值（Windows 下为末尾数字列，macOS/Linux 下为 COMMAND 列前的数字）
二、终止占用端口的进程
获取 PID 后，向该进程发送终止信号，强制释放端口，使 npm start 能重新成功绑定。
1、Windows 系统执行：taskkill /PID 12345 /F（将 12345 替换为上一步查得的实际 PID）
2、macOS 或 Linux 系统执行：kill -9 12345
3、验证端口是否已空闲：重复执行查找命令，确认无任何输出结果
三、修改 npm start 启动脚本指定端口
绕过端口冲突，直接在启动命令中注入新端口参数，无需修改源码即可临时生效。
1、查看 package.json 中 scripts 的 start 字段，例如 "start": "node server.js"
2、在终端中执行：npm start -- --port 3001（适用于支持 --port 参数的框架如 Express + serve-static 或某些 CLI 封装）
3、若不支持，可改用：PORT=3001 npm start（macOS/Linux）或 set PORT=3001 && npm start（Windows）
四、调整应用代码监听逻辑
在服务入口文件中引入端口弹性配置，使应用自动选用环境变量或备用端口，避免硬编码导致冲突。
1、打开 server.js、app.js 或 index.js 等启动文件
2、查找类似 app.listen(3000) 或 server.listen(3000) 的语句
3、将其替换为：const port = process.env.PORT || 3001; app.listen(port)
五、清理残留的 Node.js 进程
开发过程中异常中断（如 Ctrl+C 未完全退出、VS Code 终止不彻底）易导致 node 实例滞留并持续占端口。
1、macOS/Linux 执行：ps aux | grep node | grep -v grep
2、Windows 执行：tasklist | findstr node
3、对每条输出中显示的可疑 PID，逐一执行对应系统的终止命令
