如何在Bitbucket中缺失环境变量时触发React的yarn build失败？

1. 在Bitbucket Pipeline脚本中前置环境变量检查 #

直接在Pipeline的构建步骤前添加Shell检查逻辑，遍历所有必填环境变量，缺失则立即终止流程：

image: node:18

pipelines:
  default:
    - step:
        name: 构建项目
        script:
          # 定义所有必填的环境变量名称
          - REQUIRED_VARS=("API_URL" "APP_SECRET" "DEPLOY_ENV")
          # 循环检查每个变量是否存在且非空
          - for var in "${REQUIRED_VARS[@]}"; do
              if [ -z "${!var}" ]; then
                echo "错误：环境变量 $var 未设置，构建终止"
                exit 1
              fi
            done
          # 检查通过后执行正常构建流程
          - yarn install
          - yarn build

注：${!var}是Shell间接引用语法，用于获取变量名对应的实际值；exit 1会让Bitbucket Pipeline识别为步骤失败。

2. 把检查逻辑整合到项目的build脚本中 #

如果不想在Pipeline里写Shell代码，可将检查逻辑放到项目的package.json脚本里：

{
  "scripts": {
    "check-env": "node -e \"const required = ['API_URL', 'APP_SECRET', 'DEPLOY_ENV']; const missing = required.filter(k => !process.env[k]); if (missing.length) { console.error('错误：缺失环境变量:', missing.join(', ')); process.exit(1); }\"",
    "build": "yarn check-env && yarn run your-actual-build-command"
  }
}

之后在Bitbucket Pipeline中直接执行yarn build即可，一旦环境变量缺失，前置的check-env脚本会先报错退出，终止整个构建。

3. 利用Bitbucket的必填变量设置（进阶） #

在仓库的「Repository settings」→「Variables」页面，添加变量时勾选「Required」选项，这样该变量未设置时，Pipeline会在启动前直接失败，根本不会进入构建步骤。此方法适合单个关键变量的强制校验，需逐个设置。

内容的提问来源于stack exchange，提问作者Abdul Basit Mangat