在 Node.js 开发过程中，端口冲突 (EADDRINUSE: address already in use) 是一个常见的错误。这篇文章将基于一次真实的调试过程，深入解析该错误的成因，并提供详细的解决方案。
一、错误分析
在启动 Node.js 服务器时，遇到了以下错误：
Error: listen EADDRINUSE: address already in use :::8060
at Server.setupListenHandle [as _listen2] (node:net:1872:16)
at listenInCluster (node:net:1920:12)
at Server.listen (node:net:2008:7)
...
错误解读
EADDRINUSE：表示端口8060已经被占用，导致当前服务器无法正常监听该端口。listen：表明问题出现在server.listen()方法，即 Express 服务器试图绑定端口时失败。
二、问题排查
1. 检查端口占用情况
使用 netstat 命令来查找 8060 端口的占用情况：
netstat -ano | findstr :8060 输出如下：
TCP 0.0.0.0:8060 0.0.0.0:0 LISTENING 37584 TCP [::]:8060 [::]:0 LISTENING 37584
可以看到，进程 37584 正在监听 8060 端口。
2. 终止占用端口的进程
使用 taskkill 命令终止该进程：
taskkill /PID 37584 /F如果终止成功，则端口 8060 释放，此时可以重新启动服务器。
然而，在这次调试过程中，执行 taskkill 时遇到了 “系统找不到指定的文件” 的问题。这通常意味着：
- 进程已经自行退出，但端口仍然被占用。
- 进程 ID (PID) 发生了变化，需要重新获取最新的 PID 进行终止。
3. 解决无法找到进程的问题
如果 taskkill 无法终止进程，可以尝试：
netstat -ano | findstr :8060再次确认端口状态。如果仍然显示 LISTENING，可以使用以下方法强制释放端口：
方法 1：重启服务器
在 Windows 上可以执行：
shutdown -r -t 0这将立即重启计算机并释放所有端口。
方法 2：使用 PowerShell 释放端口
如果不想重启，可以用 PowerShell 终止占用进程：
Stop-Process -Id 37584 -Force或者：
Get-Process | Where-Object { $_.Id -eq 37584 } | Stop-Process -Force三、服务器成功启动
在成功释放 8060 端口后，重新运行 npm start，服务器正常启动：
Server is up and running on port: 8060 Database initialized! query: SELECT COUNT(1) AS `cnt` FROM `tasks` `tasks` query: SELECT task_id, project_id, title, description, status FROM `tasks` ORDER BY task_id DESC LIMIT 10
日志显示服务器正在查询数据库，并返回 tasks 和 users 表的数据，证明应用已经恢复正常。
四、如何预防端口占用问题？
为了避免 EADDRINUSE 错误，可以采取以下措施：
1. 启动前检查端口是否被占用
可以在 app.ts 中添加以下代码：
import net from 'net'; const PORT = 8060; const server = net.createServer(); server.once('error', (err: any) => { if (err.code === 'EADDRINUSE') { console.error(`Port ${PORT} is already in use. Please choose a different port.`); process.exit(1); } }); server.once('listening', () => server.close()); server.listen(PORT);这样，在服务器启动时会检测端口是否被占用，避免直接崩溃。
2. 自动寻找可用端口
可以使用 portfinder 自动查找可用端口：
import express from 'express'; import portfinder from 'portfinder'; const app = express(); portfinder.getPortPromise() .then((port) => { app.listen(port, () => { console.log(`Server running on port ${port}`); }); }) .catch((err) => console.error(err));3. 使用 process.env.PORT
在 .env 文件中定义端口：
PORT=8060然后在 app.ts 里使用：
const PORT = process.env.PORT || 3000; app.listen(PORT, () => console.log(`Server running on port ${PORT}`));这样可以灵活调整端口，避免冲突。
五、总结
在本次调试过程中，我们遇到了 EADDRINUSE 端口占用错误，经过以下步骤成功解决：
- 使用
netstat确定占用端口的进程。 - 使用
taskkill终止进程，或通过 PowerShell 释放端口。 - 若仍然占用，可以重启计算机或动态分配端口。
- 在代码中增加端口检测逻辑，避免应用崩溃。
希望这篇文章能帮助你解决类似的端口冲突问题！🚀