Jenkins声明式流水线判断变量为空报错求助

问题背景 #

需求是通过Jenkins声明式流水线实现：当目标AMI已存在时，跳过Build阶段。用户最初编写的声明式流水线代码如下：

stage('Build') {
  environment {
    AMI = sh(returnStdout: true, script: 'aws ec2 describe-images').trim()
  }
  when {
    expression { AMI = null } // 此处为赋值操作，并非判断相等的语法
  }
  steps {
    sh 'packer build base.json -machine-readable'
  }
}

运行时抛出异常：

groovy.lang.MissingPropertyException: No such property: AMI for class: groovy.lang.Binding

用户尝试了多种when条件写法均无效：

// 写法1
when {
  expression {
    return AMI.isEmpty()
  }
}

// 写法2
when {
  not {
    expression {
      AMI == ''
  }
}

// 写法3
when {
  not {
    expression { env.AMI }
  }
}

而对应的脚本式流水线代码可正常运行：

stage('Build') {
  steps {
    script {
      env.AMI = sh(returnStdout: true, script: 'aws ec2 describe-images').trim()
        if (env.AMI == '') {
          sh 'packer build base.json -machine-readable'
        }
      }
    }
  }
}

问题原因 #

核心原因是声明式流水线的when条件评估时机早于阶段内environment块的初始化：

• when条件在阶段启动前就会执行，而stage内部的environment块要等到阶段正式启动后才会初始化变量，因此when里根本访问不到该块定义的AMI变量，这就是抛出MissingPropertyException的直接原因。
• 另外，最初代码里的AMI = null是赋值操作，不是判断相等的语法，本身就存在错误。

解决方案 #

方案1：在when的expression中直接执行判断命令 #

直接在when条件里调用aws命令判断AMI是否不存在，无需依赖环境变量：

pipeline {
  agent any
  stages {
    stage('Build') {
      when {
        expression {
          // 根据实际需求调整aws命令的过滤条件（比如指定AMI名称）
          def amiResult = sh(returnStdout: true, script: 'aws ec2 describe-images --filters "Name=name,Values=your-target-ami-name"').trim()
          // 当返回结果为空或空数组时，说明AMI不存在，执行Build阶段
          return amiResult.isEmpty() || amiResult == '[]'
        }
      }
      steps {
        sh 'packer build base.json -machine-readable'
      }
    }
  }
}

方案2：将变量定义在流水线全局environment块 #

把AMI状态变量定义在流水线级别的environment中，这样when条件可以正常访问：

pipeline {
  agent any
  environment {
    // 使用jq判断是否存在符合条件的AMI（需确保Jenkins agent已安装jq）
    AMI_EXISTS = sh(
      returnStdout: true,
      script: 'aws ec2 describe-images --filters "Name=name,Values=your-target-ami-name" | jq -e ".Images | length > 0" || echo "false"'
    ).trim()
  }
  stages {
    stage('Build') {
      when {
        expression { AMI_EXISTS == 'false' }
      }
      steps {
        sh 'packer build base.json -machine-readable'
      }
    }
  }
}

注意事项 #

• 调整aws ec2 describe-images命令时，建议添加具体的过滤条件（比如AMI名称、所有者等），避免返回大量无关结果导致判断逻辑出错。
• 如果使用jq工具，需要确保Jenkins运行的agent节点已安装该工具。

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