Plesk部署Node.js Express REST API报错及前置准备求助

• 端口配置问题
  别硬写固定端口，用环境变量适配部署平台：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`Server running on port ${port}`);
  });
  

  服务器端如果端口被占用，用以下命令排查并处理占用进程：

  # Linux/macOS
  lsof -i :3000
  # Windows
  netstat -ano | findstr :3000
  

• 依赖未正确安装
  不要直接上传本地的node_modules文件夹，部署时在目标环境执行：

  npm install --production
  

  同时确认package.json中的start脚本正确指向项目入口文件：

  "scripts": {
    "start": "node server.js"
  }
  

• 环境变量缺失
  数据库连接字符串、API密钥这类敏感信息别写死在代码里，用process.env.XXX的方式读取，然后在部署平台的后台配置对应环境变量（比如平台内置的环境变量管理模块）。

• 权限或资源问题
  Linux服务器上绑定1024以下端口需要root权限，建议用Nginx反向代理到高位端口；同时检查Node进程是否有读写日志、静态文件等资源的权限。

• 查看完整错误日志
  部署平台提供的完整错误日志会包含详细的报错栈信息，比如模块缺失、语法错误、数据库连接失败等，根据日志信息精准定位问题，不要只依赖表面的错误提示。

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