Jenkins配置when分支条件后部署阶段被跳过、流水线显示成功但未执行部署

你遇到的现象同时触发了两个Jenkins Pipeline的经典配置问题，最终表现为所有部署阶段被无理由跳过、审批动作失效。 #

两类核心问题拆解 #

1. 所有分支匹配条件永久判定不通过 #

when { branch 'xxx' }的判定逻辑完全依赖Jenkins内置注入的BRANCH_NAME环境变量，常见的失效场景包括：

• 当前Jenkins任务不是多分支流水线（Multibranch Pipeline）类型：如果是普通单Pipeline任务，手动配置Git仓库拉取代码、没有开启分支发现逻辑，Jenkins根本不会自动注入BRANCH_NAME变量，所有分支条件都会判定为空匹配
• 分支名格式不匹配：Jenkins实际拿到的分支名带origin/前缀（比如真实值是origin/dev）、或是流水线检出的是Tag/固定Commit SHA（没有关联分支名，BRANCH_NAME为空），就会出现配置branch 'dev'却匹配不上实际dev分支的情况
• 大小写差异：比如实际分支是Development，配置里写的是小写的dev，也会匹配失败

2. 审批动作失效的执行顺序问题 #

Jenkins Pipeline有个很容易踩的顺序坑：

当Stage块内同时存在和steps、when平级的顶层input配置时，when条件的判定会被延后到input审批完成之后才执行，而不是按照常规逻辑在进入Stage前先判定when。
这就是你的日志里会出现“先弹审批框、等管理员点完同意、才判定when不通过、直接跳过部署”的原因——整个审批流程完全被浪费了。

分步排查修复流程 #

第一步：先定位分支匹配失败的真实原因 #

在流水线最开头加一段调试逻辑，把Jenkins实际拿到的分支值打出来，直接定位问题：

pipeline {
  agent any
  stages {
    stage('分支信息调试') {
      steps {
        echo "Jenkins内置拿到的BRANCH_NAME值为: [${env.BRANCH_NAME}]"
        sh 'git rev-parse --abbrev-ref HEAD' // 打印实际检出的本地分支名
      }
    }
    // 后续接你原来的部署阶段即可
  }
}

跑一次流水线根据输出对应修复：

• 如果BRANCH_NAME是空值：说明任务不是多分支流水线类型，需要把任务改成Multibranch Pipeline，配置好Git仓库的分支发现规则，让Jenkins自动给每次运行注入正确的分支名
• 如果输出的分支名带origin/前缀：可以把when的匹配规则改成支持模糊匹配的正则写法，比如when { branch '.*dev' }，兼容带前缀的分支名
• 如果输出的分支名和预期完全不符：说明Git检出的步骤配置错了，拉的代码分支和预期不一致

第二步：修复when执行顺序，避免先审批后跳过 #

可以选两种修复方案里的任意一种：

方案A：把input块挪到steps内部

调整代码结构，把原本写在stage顶层的input移到steps块里，when就会回到“进入Stage前先判定”的默认逻辑，不会再触发先弹审批的反常流程：

stage('Deploy to Staging') {
  when { branch 'dev' }
  environment {
      KUBECONFIG = credentials('kubeconfig')
  }
  steps {
    // input移到steps内部，不会打乱when的执行顺序
    input{message "Deploy staging deployment?"}
    sh 'kubectl --kubeconfig=${KUBECONFIG} --namespace=${STAGING_ENVIRONMENT} --record deployment/api set image deployment/api api=wizelinedevops/samuel:${BUILD_NUMBER}' 
  }
}

stage('Deploy to Production') {
  when { branch 'master' }
  environment {
      KUBECONFIG = credentials('kubeconfig')
  }
  steps {
    input{message "Deploy production deployment?"}
    sh 'kubectl --kubeconfig=${KUBECONFIG} --namespace=${PROD_ENVIRONMENT} --record deployment/api set image deployment/api api=wizelinedevops/samuel:${BUILD_NUMBER}' 
  }
}

方案B：强制when在input之前执行

如果一定要把input放在stage顶层，可以给when加beforeInput true参数，强制when的判定优先于input审批，从根源上跳过“先审批、后跳过”的问题：

stage('Deploy to Staging') {
  when {
    branch 'dev'
    beforeInput true // 强制when在input审批前完成判定
  }
  input{message "Deploy staging deployment?"}
  environment {
      KUBECONFIG = credentials('kubeconfig')
  }
  steps {
    sh 'kubectl --kubeconfig=${KUBECONFIG} --namespace=${STAGING_ENVIRONMENT} --record deployment/api set image deployment/api api=wizelinedevops/samuel:${BUILD_NUMBER}' 
  }
}

第三步：兜底兼容分支匹配逻辑 #

如果调整完还是有匹配失效的问题，可以不依赖Jenkins内置的branch条件，直接用Git命令拿到的实际分支名做判断，逻辑更透明：

stage('Deploy to Dev') {
  when {
    expression {
      // 直接基于Git命令输出的实际分支名判断，不依赖Jenkins内置变量
      return sh(returnStdout: true, script: 'git rev-parse --abbrev-ref HEAD').trim() == 'dev'
    }
  }
  // 后续部署步骤保持不变
}

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