如何让Heroku staging环境自动跳过S3存储代码（Node.js/Express）

这问题太懂了！手动注释代码不仅容易忘，还容易搞出分支冲突，用环境变量就能完美解决这个自动化需求，完全不用改代码逻辑，只靠配置区分环境。下面是具体步骤，基于Node.js + Express：

1. 给Heroku的不同环境设置专属环境变量 #

Heroku允许给每个应用实例单独设置环境变量，我们可以用这个来标记当前是staging还是production环境：

方法一：用标准的NODE_ENV变量（推荐） #

这是Node.js生态的通用约定，很多框架和工具都会识别这个变量：

• 给staging应用设置：

  heroku config:set NODE_ENV=staging --app your-staging-app-name
  

• 给production应用设置：

  heroku config:set NODE_ENV=production --app your-production-app-name
  

方法二：用自定义开关变量 #

如果需要更灵活的控制（比如某天想在staging测试S3上传），可以单独加个开关：

• staging环境关闭S3：

  heroku config:set ENABLE_S3_UPLOAD=false --app your-staging-app-name
  

• production环境开启S3：

  heroku config:set ENABLE_S3_UPLOAD=true --app your-production-app-name
  

2. 在Express应用中读取环境变量并做条件判断 #

在你的业务代码里，通过process.env读取环境变量，然后包裹S3相关的逻辑：

用NODE_ENV的示例： #

// 可以把这个判断抽成全局变量，方便多处使用
const isProduction = process.env.NODE_ENV === 'production';

// 业务逻辑中的S3上传部分
async function saveDataAndUploadToS3(data) {
  // 先执行通用的保存逻辑（比如存数据库）
  await saveToDatabase(data);

  // 仅在production环境执行S3上传
  if (isProduction) {
    try {
      // 你的S3上传代码，比如用AWS SDK v3
      const s3 = new S3Client({ region: 'your-region' });
      await s3.send(new PutObjectCommand({
        Bucket: 'your-bucket-name',
        Key: `data/${Date.now()}.json`,
        Body: JSON.stringify(data)
      }));
      console.log('数据已上传到S3');
    } catch (err) {
      console.error('S3上传失败:', err);
      // 这里可以加错误告警逻辑
    }
  } else {
    console.log('跳过S3上传：当前环境为', process.env.NODE_ENV);
  }
}

用自定义开关的示例： #

// 读取开关变量，默认关闭（防止意外）
const shouldUploadToS3 = process.env.ENABLE_S3_UPLOAD === 'true';

// 业务逻辑中
if (shouldUploadToS3) {
  // 执行S3上传
} else {
  // 跳过上传
}

3. 本地开发的适配（可选） #

本地开发时，可以用dotenv包来模拟环境变量，不用每次手动输入：

1. 安装依赖：

   npm install dotenv --save-dev
   

2. 在项目根目录创建.env文件：

   NODE_ENV=development
   # 或者 ENABLE_S3_UPLOAD=false
   

3. 在Express的入口文件（比如app.js）最顶部加载dotenv：

   require('dotenv').config();
   

这样本地运行时就会自动读取.env里的变量，和Heroku环境保持一致的逻辑。

一些额外的最佳实践 #

• 不要把环境变量硬编码到代码里，Heroku的Config Vars是加密存储的，更安全；
• 如果用AWS SDK，推荐把S3的密钥也通过环境变量设置（比如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY），不要提交到代码仓库；
• 可以在staging环境临时打开S3开关，测试上传逻辑，测试完再关闭，不用改代码。

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