AWS Elastic Beanstalk部署时如何加载文件中环境变量供Node.js通过process.env访问

问题根因 #

当前拉取脚本仅将export规则写入/home/ec2-user/.env.local文件，但Node应用启动时的运行上下文和生成该文件的shell上下文完全独立，不会主动加载文件内的导出配置，因此process.env中不存在这些变量，自然无法正常读取。

落地配置步骤 #

1. 修正.ebextensions脚本的执行阶段与格式问题 #

原脚本使用commands阶段执行，存在应用目录未就绪、文件属主为root、变量值格式易出错的问题，调整为container_commands阶段执行（该阶段在应用代码部署完成、进程启动前运行，和应用启动上下文对齐），修正后的完整配置如下：

container_commands:
  01_fetch_ssm_params:
    # 拉取SSM参数并生成带引号包裹的.env.local文件，避免特殊字符报错
    command: |
      aws ssm get-parameters-by-path --path /latest/ --recursive --with-decryption \
      --output text --query "Parameters[].[Name,Value]" --region us-west-2 \
      | sed -E 's#latest/([^[:space:]]*)[[:space:]]*#export "\1"="#' \
      | sed -E 's#$#"#' > /home/ec2-user/.env.local
    # 以ec2-user身份执行，确保生成的文件属主为Node运行用户
    user: ec2-user
    # 配置文件权限，仅属主可读写，避免敏感信息泄露
    command: chmod 600 /home/ec2-user/.env.local

补充要求：需要给EB实例关联的IAM角色添加SSM参数读取权限（允许ssm:GetParametersByPath、ssm:GetParameters操作），否则拉取参数时会返回权限错误。

2. 实现Node进程启动前自动加载.env.local变量 #

核心逻辑是在Node进程启动前，先加载.env.local中的所有export配置，Node作为shell的子进程启动时会自动继承父级的所有环境变量，完全不需要改动业务代码里process.env.xxx的读取逻辑，可二选一使用以下方式：

• 方式一：挂钩EB内置启动流程（适合所有项目通用）
  在同一.ebextensions配置中追加钩子逻辑，在Node启动脚本中插入source加载逻辑，不需要改动项目代码：

  container_commands:
    02_hook_start_script:
      command: |
        START_SCRIPT=/opt/elasticbeanstalk/hooks/appdeploy/enact/00_start_nodejs.sh
        # 避免重复插入加载逻辑
        if ! grep -q "\. /home/ec2-user/.env.local" $START_SCRIPT; then
          sed -i '/node/i \. /home/ec2-user/.env.local' $START_SCRIPT
        fi
  

• 方式二：修改项目package.json的启动命令（不依赖EB内置逻辑，更灵活）
  保持业务代码完全不动，仅修改package.json里的start配置，在启动Node前先source环境文件：
  原配置：

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

  修改为：

  "scripts": {
    "start": "source /home/ec2-user/.env.local && node index.js"
  }
  

校验方法 #

部署完成后登录EC2实例，执行以下命令验证是否能正常读取变量：
source /home/ec2-user/.env.local && node -e "console.log(process.env.你的测试变量名)"
如果能正常打印出对应值，说明配置生效，业务代码中原有的process.env读取逻辑可以完全无改动运行。

注意事项 #

• 确保生成的.env.local中的变量名和原EB控制台配置的变量名完全一致，不需要适配业务代码的读取规则。
• 不要将动态生成的.env.local提交到代码仓库，需将其加入.gitignore。
• 必须给.env.local中的变量值加上双引号包裹，否则值中包含空格、特殊字符时会出现shell语法错误，导致加载失败。

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