Elastic Beanstalk部署Node.js失败：实例版本异常与Swap命令错误

以下是针对该问题的具体解决步骤：

1. 定位swap脚本的具体错误 #

登录Elastic Beanstalk关联的EC2实例，手动执行默认的swap启用脚本，捕获具体报错细节：

sudo /opt/elasticbeanstalk/hooks/appdeploy/pre/01_enable_swap.sh

常见触发错误的原因包括：根磁盘空间不足、swap文件创建权限受限、脚本内命令语法与当前实例系统版本不兼容（比如Amazon Linux 2和Amazon Linux 2023的命令差异）。

2. 自定义swap配置覆盖默认脚本 #

在Node.js项目根目录创建.ebextensions/swap-fix.config文件，用自定义逻辑替换默认的swap钩子脚本，绕开原脚本的问题：

commands:
  01_create_swap:
    command: |
      # 仅在swap文件不存在时执行创建操作
      if [ ! -f /var/swapfile ]; then
        # 用fallocate替代dd，创建swap文件更高效
        fallocate -l 2G /var/swapfile
        chmod 600 /var/swapfile
        mkswap /var/swapfile
        swapon /var/swapfile
      fi
  02_persist_swap:
    command: |
      # 确保swap在系统重启后自动挂载
      if ! grep -q "/var/swapfile" /etc/fstab; then
        echo "/var/swapfile swap swap defaults 0 0" >> /etc/fstab
      fi

将该文件提交到Git仓库，触发CodePipeline重新部署，此配置会跳过默认的01_enable_swap脚本，自行完成swap配置。

3. 检查并清理实例磁盘空间 #

若磁盘空间不足导致swap文件无法创建：

• 执行df -h查看实例根卷剩余空间，通过Elastic Beanstalk控制台调整旧应用版本保留数量，清理冗余文件
• 扩展EC2实例的根卷容量，或切换到更大规格的实例类型

4. 修复环境状态不一致问题 #

若此前部署中断导致实例状态混乱：

• 在Elastic Beanstalk控制台执行「重建环境」操作，重新创建所有EC2实例，清除残留的不一致状态
• 可在CodePipeline部署阶段添加前置步骤，调用AWS CLI命令自动重建环境：

aws elasticbeanstalk rebuild-environment --environment-name <你的环境名称>

5. 验证平台版本兼容性 #

近期Elastic Beanstalk的Node.js平台版本更新可能引发脚本兼容性问题：

• 回退到之前能正常部署的平台版本（在环境配置的「平台」选项中调整）
• 升级到最新稳定版平台，测试是否解决脚本适配问题

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