Jenkins多分支流水线如何在参数未初始化时仅执行指定stage

核心逻辑是利用Jenkins多分支流水线首次运行时的特性：未加载过Jenkinsfile参数定义时，自定义参数的取值默认为null，也可结合首次构建编号判断参数是否完成初始化，通过声明式流水线的when条件控制指定stage的执行范围。

方案1：基于参数空值判断（最常用） #

首次运行时Jenkins还未同步参数配置到作业，你定义的choice、string类型参数都会返回null，直接在stage的执行条件中判断即可：

pipeline {
  agent any
  // 你的原始参数定义
  parameters {
    choice(name: 'ENV_TYPE', choices: ['dev', 'test', 'prod'], description: '部署环境类型')
    string(name: 'DEPLOY_VERSION', defaultValue: '', description: '部署版本号')
  }
  stages {
    // 仅参数未初始化时执行的stage
    stage('参数初始化引导') {
      when {
        // 任意自定义参数为null即判定为未初始化
        expression { return params.ENV_TYPE == null || params.DEPLOY_VERSION == null }
      }
      steps {
        echo '检测到当前为分支首次运行，参数未初始化，当前stage仅执行1次'
        // 此处可填入你需要的初始化逻辑，比如设置默认值、输出提示等
        // 可选：直接终止首次构建，避免后续阶段报参数不存在错误
        currentBuild.result = 'ABORTED'
        error('参数定义已同步完成，请重新触发流水线即可正常选择参数')
      }
    }
    // 你的正常业务stage
    stage('构建部署') {
      when {
        // 确保参数初始化完成才执行业务逻辑
        expression { return params.ENV_TYPE != null && params.DEPLOY_VERSION != null }
      }
      steps {
        echo "当前部署环境：${params.ENV_TYPE}，部署版本：${params.DEPLOY_VERSION}"
        // 正常业务逻辑
      }
    }
  }
}

方案2：基于首次构建编号判断（更精准） #

如果存在参数被手动设为空值的场景，可结合构建编号判断，分支首次构建的编号固定为1，不会受参数取值影响：

stage('参数初始化引导') {
  when {
    expression { return currentBuild.number == 1 }
  }
  steps {
    // 初始化逻辑和方案1一致
  }
}

注意事项 #

• 声明式流水线的parameters块必须定义在pipeline根节点下，多分支流水线会在首次运行完成后自动把参数同步到作业配置中，第二次运行就会正常显示参数选择界面
• 如果不需要终止首次构建，可以删除终止逻辑，仅在后续业务stage添加参数初始化判断即可
• 脚本式流水线可直接用if判断包裹对应逻辑，实现效果和声明式的when条件完全一致

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