Heroku本地运行提示端口5000已占用，修改代码后重复报错如何解决？

1 优先排查系统级端口占用 #

MacOS Monterey（12.x）及以上版本系统默认会用5000端口运行AirPlay接收器，这是导致端口占用提示的高频原因：

• 执行sudo lsof -i :5000查看占用进程，如果PID对应的进程名为ControlCenter，即可确认是系统占用
• 解决方法：打开系统设置→通用→AirDrop与Handoff，关闭「AirPlay接收器」开关即可释放5000端口
  Windows用户排查方法：执行netstat -ano | findstr :5000找到占用端口的PID，到任务管理器中结束对应进程即可

2 修复服务端代码，主动释放端口 #

你的Express服务没有监听进程退出信号，nodemon热重载杀死旧进程时，端口可能不会被主动释放，修改服务端代码末尾的监听逻辑：

// 原代码：const PORT = process.env.PORT || 5000;
// 原代码：app.listen(PORT, () => console.log(`Server running on port ${PORT}`));
// 替换为以下代码：
const PORT = process.env.PORT || 5000;
const server = app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

// 监听进程终止信号，主动关闭服务释放端口
process.on('SIGTERM', () => {
  server.close(() => process.exit(0))
})
process.on('SIGINT', () => {
  server.close(() => process.exit(0))
})

3 修改nodemon启动配置，强制销毁旧进程 #

修改package.json中的server脚本，添加强制杀进程的参数：

"server": "nodemon --signal SIGKILL backend/server.js",

该配置会让nodemon在热重载时，强制杀死旧的服务进程，避免进程残留占用端口。

4 heroku local端口占用解决方案 #

heroku local默认优先使用5000端口，你可以两种方式避开冲突：

• 启动时指定端口：执行heroku local -p 5001
• 固定端口配置：在项目根目录的.env文件中添加一行PORT=5001，heroku local启动时会自动读取该配置

内容的提问来源于stack exchange，提问作者Sygut