AWS Elastic Beanstalk部署Node.js应用未指定版本且健康状态严重如何解决

解决方案 #

按以下优先级依次排查修复：

• 指定Node.js版本
  部署日志已明确提示未指定Node.js版本，在package.json中新增engines字段，版本和你本地开发使用的Node.js版本保持一致即可，示例：

  {
    "name": "node-template",
    "version": "1.0.0",
    "main": "index.js",
    // 新增以下字段
    "engines": {
      "node": "16.x"
    },
    "scripts": {
      "start": "node ./index.js"
    },
    // 其余原有配置保持不变
  }
  

• 修正服务监听端口配置
  这是最常见的健康状态异常原因：Elastic Beanstalk Node.js环境会通过PORT环境变量动态分配服务端口，不能在代码中写死固定端口。修改index.js中的监听逻辑：

  // 原代码如果是 app.listen(3000, ...) 替换为以下内容
  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`服务已启动，监听端口${port}`);
  });
  

• 调整依赖配置
  nodemon是本地开发热重载工具，不需要在生产环境安装，将其从dependencies移动到devDependencies中，同时保持start脚本使用node启动，不要改为nodemon。

• 配置健康检查路由
  Elastic Beanstalk默认会向应用根路径/发送GET请求判断服务是否正常，如果你的应用根路径返回404等非200状态码，健康检查会失败。可以新增专门的健康检查路由：

  app.get('/health', (req, res) => {
    res.status(200).send('正常');
  });
  

  之后在AWS Elastic Beanstalk控制台的环境配置-监控页面，将健康检查路径修改为/health即可。

所有修改完成后，执行eb deploy命令重新部署应用，等待3-5分钟环境状态即可恢复正常。

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