部署Elastic Beanstalk Node.js/Express服务遇502错误求助

一、修复.ebextensions配置导致的部署失败问题 #

如果你的nodecommand.config格式错误会直接中断部署，正确配置示例如下（根据你的启动文件调整）：

option_settings:
  aws:elasticbeanstalk:container:nodejs:
    NodeCommand: "node server.js"

• 严格遵循YAML缩进规则：用空格而非制表符，层级缩进一致
• 若使用npm start启动，需确保package.json的scripts字段包含start命令，再将配置改为：

  NodeCommand: "npm start"
  

  对应package.json示例：

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

二、排查502 Bad Gateway核心原因 #

502通常是Nginx无法连接Node.js进程，按以下方向逐一排查：

1. 确认Node进程监听端口 #

Elastic Beanstalk会自动注入PORT环境变量，Express代码必须监听该变量指定的端口，禁止硬编码端口：

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

2. 检查应用启动日志 #

通过Elastic Beanstalk控制台日志选项卡下载完整日志包，查看/var/log/nodejs/nodejs.log：

• 排查是否存在启动报错（如依赖缺失、语法错误）
• 确认日志中输出Server running on port XXXX，证明进程正常启动

3. 验证健康检查配置 #

Elastic Beanstalk默认健康检查路径为/，需确保Express应用对该路径返回200状态码：

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

若使用自定义健康检查路径，需在控制台配置>负载均衡器中修改对应设置。

4. 核对Nginx反向代理配置 #

查看Nginx配置文件/etc/nginx/conf.d/elasticbeanstalk/00_application.conf，确认proxy_pass指向的端口与Node进程监听的PORT一致：

location / {
    proxy_pass http://127.0.0.1:8080; # 端口需匹配Node进程实际监听端口
    proxy_set_header Connection "";
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

5. 优化生产环境部署配置 #

• 无需手动设置NPM_CONFIG_PRODUCTION=true，Elastic Beanstalk默认会在生产环境跳过devDependencies安装
• 确保package.json的dependencies包含所有生产必需依赖，devDependencies仅存放开发工具类包

三、快速验证流程 #

1. 本地执行npm start，确认应用正常启动且http://localhost:3000可访问
2. 检查代码是否正确读取process.env.PORT变量
3. 修正nodecommand.config格式后重新部署
4. 部署完成后查看nodejs.log确认进程启动状态

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