AWS Elastic Beanstalk重建环境后eb deploy未运行Node脚本求助

我之前也碰到过一模一样的情况——重建EB环境后，部署没报错但服务就是不启动，折腾了好一阵才找到问题。下面是几个实用的排查和修复步骤，你可以逐一尝试：

1. 先查日志，找到隐藏的真相 #

没有报错不代表没出问题，EB的日志里肯定藏着线索：

• 运行 eb logs 拉取全量日志，重点盯这几个文件：
  • /var/log/nodejs/nodejs.log：Node.js应用的输出日志，包括那些没抛到控制台的静默错误
  • /var/log/eb-engine.log：EB部署引擎的运行日志，能看到依赖安装、环境配置的全过程
  • /var/log/web.stdout.log：Web服务的标准输出，可能记录着启动失败的细节
• 如果日志太杂，也可以指定实例或日志组拉取：eb logs --instance <你的实例ID> 或者 eb logs --log-group /aws/elasticbeanstalk/stage/var/log/nodejs/nodejs.log

2. 确认EB平台的启动命令配置 #

Amazon Linux 2上的Node.js平台默认会读取package.json的start脚本，但重建环境后配置可能被重置：

• 运行 eb config 查看环境配置，找到 aws:elasticbeanstalk:container:nodejs 模块，检查NodeCommand项：
  • 如果是空值，EB本该默认执行npm start，但你可以显式设置为npm start或者node app.js
  • 也可以直接去EB控制台，在「配置」→「软件」页面的「Node command」输入框填写npm start，保存后重新部署

3. 排查依赖安装是否成功 #

重建环境时npm install可能因为版本兼容问题悄悄失败，导致服务启动不了：

• 用 eb ssh 登录到EC2实例，进入应用目录：cd /var/app/current
• 手动运行 npm install，看看有没有报错
• 注意到你的package.json里socket.io用了latest版本，而Node.js 12已经停止维护，最新的socket.io版本（比如v4.6+）已经不再支持Node.js 12了。建议改成兼容的固定版本，比如：

  "socket.io": "^4.5.4"
  

  这个版本明确支持Node.js 12+，改完重新部署试试

4. 检查dotenv的环境变量配置 #

你用到了dotenv，如果缺少必要的环境变量，应用可能直接静默退出：

• 别依赖本地的.env文件（git通常会忽略它，不会部署到实例），应该把变量配置到EB的环境变量里：
  • 运行 eb setenv KEY=VALUE 设置变量，或者在EB控制台的「配置」→「软件」→「环境变量」里添加
  • Amazon Linux 2的EB平台会自动把这些变量注入到Node.js进程中，不用再靠dotenv加载本地文件

5. 查看Node.js服务的systemd状态 #

Amazon Linux 2用systemd管理Node.js服务，直接看服务状态能快速定位问题：

• eb ssh登录实例后，运行：

  sudo systemctl status nodejs
  

  看看服务是不是处于active (running)状态，如果是failed或inactive，下方的错误信息会告诉你原因（比如启动超时、依赖缺失）
• 如果服务启动后又立刻退出，还可以实时查看日志：

  sudo journalctl -u nodejs -f
  

6. 确认应用文件是否正确部署 #

偶尔会碰到重建环境后，部署流程没把文件传到实例的情况：

• eb ssh登录后，检查/var/app/current目录下有没有app.js和package.json
• 如果文件缺失，试试重新运行 eb deploy --staged（如果有未提交的修改），或者确认当前git分支是master（你的EB配置里master分支对应stage环境）

我之前就是因为socket.io的latest版本和Node.js 12不兼容，导致npm install失败但EB没提示，查了日志才找到问题。按上面的步骤排查，应该能解决你的问题。

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