Node.js+Express修改代码重启报端口占用及process.env.PORT含义咨询

你更换端口后仍提示占用，核心原因是之前启动的Node服务进程没有正常退出，一直在后台持续占用端口，按以下步骤处理即可：

• 杀死残留的Node进程
  • Linux/macOS环境执行命令：
    1. 查询占用指定端口的进程PID：lsof -i:<端口号>
    2. 杀死对应进程：kill -9 <PID>
    3. 若要一次性清理所有未退出的Node进程，可执行：pkill -f node（注意：若你有其他运行中的Node服务需要保留，请勿执行该命令）
  • Windows环境执行命令：
    1. 查询占用指定端口的进程PID：netstat -ano | findstr "<端口号>"
    2. 杀死对应进程：taskkill /PID <PID> /F
• 避免后续重复出现该问题
  不要手动启停服务，使用nodemon工具实现代码修改后自动热重启，它会自动处理进程退出逻辑，不会出现进程残留：
  1. 全局安装nodemon：npm install -g nodemon
  2. 后续启动服务使用命令：nodemon index.js
• 可选优化：给代码加自动端口重试逻辑，遇到端口占用时自动尝试下一个端口，无需手动修改或杀进程：

// 替换原有的app.listen部分代码
const DEFAULT_PORT = 8005;
function startServer(port) {
  const server = app.listen(port, (err) => {
    if (err) {
      if (err.code === 'EADDRINUSE') {
        console.log(`端口${port}已被占用，尝试使用端口${port + 1}`);
        startServer(port + 1);
        return;
      }
      return console.log(err);
    }
    console.log(`服务已启动，监听端口：${port}`);
  })
}
startServer(process.env.PORT || DEFAULT_PORT);

• 含义：process.env是Node.js内置的全局对象，用于存储当前Node进程运行时的所有环境变量，process.env.PORT就是其中名为PORT的环境变量的值，该值不是固定的，会随运行环境的配置变化。
• 作用：
  • 适配线上部署场景：大部分云托管平台都会动态给服务分配可用端口，不会允许开发者写死固定端口，此时服务会自动读取平台分配的process.env.PORT值进行监听，保证部署后正常启动。
  • 提升本地开发灵活性：无需修改代码即可调整服务监听端口，比如本地启动时指定端口为3000，Linux/macOS可执行PORT=3000 node index.js，Windows cmd可执行set PORT=3000 && node index.js，PowerShell可执行$env:PORT=3000; node index.js。
  • 多环境兼容：通过const PORT = process.env.PORT || 8005的写法，可以同时兼容本地开发和线上部署环境，不需要针对不同环境修改代码。

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