AWS部署Node.js项目时CodeBuild环境变量无法读取如何解决

CodeBuild 配置的自定义环境变量仅在CodeBuild构建容器的生命周期内生效，构建任务结束后容器会被直接销毁，这些环境变量不会自动同步到CodeDeploy部署的EC2运行环境，因此Node.js服务启动后无法通过process.env读到对应值——你的process.env读取方式本身没有问题，本质是构建阶段的环境变量没有传递到服务运行阶段。

你不需要修改Node.js层读取环境变量的逻辑，根据配置的敏感等级选以下任意一种方案即可：

• 非敏感配置：构建阶段注入到产物的.env文件
  适合非密钥类的普通配置，直接在buildspec.yml构建流程中把CodeBuild里的变量写入.env文件，随构建产物一起通过CodeDeploy部署到EC2，代码侧用dotenv加载即可。
  示例buildspec.yml配置：

  version: 0.2
  phases:
    install:
      commands:
        - npm install
    build:
      commands:
        # 将CodeBuild中的环境变量写入.env文件
        - echo "CUSTOM_VARIABLE=$CUSTOM_VARIABLE" >> .env
        - npm run build # 有编译步骤则保留，无则可删除
  artifacts:
    files:
      - "**/*" # 确保.env文件被打包进构建产物传递给CodeDeploy
  

  代码入口文件最顶部提前引入dotenv配置即可：

  require('dotenv').config()
  // 后续业务代码正常读process.env.CUSTOM_VARIABLE即可
  

• 敏感/多环境配置：部署阶段通过启动脚本注入运行时变量
  适合密钥类、不同环境值差异大的配置，和你当前手动export的逻辑兼容，且不会把敏感值打包到代码产物中：

  1. 给EC2实例绑定的IAM角色添加SSM参数读取权限，把不同环境的变量值存在AWS Systems Manager Parameter Store中，按环境分层命名比如/dev/CUSTOM_VARIABLE、/staging/CUSTOM_VARIABLE
  2. 在CodeDeploy的应用启动脚本中拉取对应参数、注入环境变量后再启动Node服务，示例启动脚本start.sh：

     #!/bin/bash
     # 识别当前实例所属环境拉取对应参数
     ENV=$(aws ec2 describe-tags --filters "Name=resource-id,Values=$(ec2-metadata -i | cut -d ' ' -f2)" "Name=key,Values=Environment" --query 'Tags[0].Value' --output text)
     export CUSTOM_VARIABLE=$(aws ssm get-parameter --name "/$ENV/CUSTOM_VARIABLE" --with-decryption --query "Parameter.Value" --output text)
     cd /opt/your-node-app-path
     # 按自己的服务托管方式启动，PM2/systemd/nohup均可
     pm2 start app.js
     

  3. 在appspec.yml中配置ApplicationStart钩子执行上述脚本即可，服务启动后就能正常读到变量。

注意：你当前手动在EC2执行export的方式仅对当前shell会话生效，实例重启、服务重启后变量会丢失，建议通过上述两种方案把变量注入逻辑固化到构建或部署流程中，避免配置丢失。

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