Jenkins声明式流水线when条件能否用Integer类型做返回码比较？

核心结论 #

• when条件完全支持Integer类型的比较操作，不存在仅支持字符串判断的限制，你当前基于shell返回码做分支判断的场景，完全可以脱离script块内的if-else逻辑，改用when条件实现。

具体实现路径 #

1. 改造前序脚本的执行逻辑，避免非零返回码直接中断流水线，同时拿到原生Integer类型的返回码：
   执行shell脚本时添加returnStatus: true参数，将返回值赋值给流水线变量：
   def preCheckRC = sh(script: './your_pre_validation_script.sh', returnStatus: true)
   这里拿到的preCheckRC是Groovy原生的Integer类型，不需要额外做类型转换。
2. 在后续依赖的stage中直接通过when的expression块写整数比较逻辑即可，比如仅当返回码为0时运行后续脚本：
   stage('后续依赖执行脚本') { when { expression { preCheckRC == 0 } } steps { sh './your_dependent_script.sh' } }
   这段逻辑和你之前在script块里写if (preCheckRC == 0) { sh './xxx.sh' }的行为完全等价，且不满足条件的stage会直接标记为跳过状态，不会出现“执行空判断块显示成功、实际未运行脚本”的状态误导。

常见避坑点 #

• 不推荐通过shell输出重定向的方式获取返回码，比如通过sh(script: 'echo $?').trim()拿到返回值再比较，这种方式拿到的是字符串类型，虽然Groovy的隐式类型转换通常能匹配，但容易出现非预期的判断结果，优先使用sh步骤原生的returnStatus参数获取返回码最稳妥。
• 所有Groovy支持的整数比较操作（大于、小于、不等于、多条件组合）都可以直接在when条件中使用，比如需要拦截返回码为3的权限错误场景，直接写when { expression { preCheckRC != 3 } }即可。

说明：when条件没有内置的类型限制，只要传入的表达式能返回布尔值，不管是整数比较、字符串匹配、布尔变量判断，都可以正常生效。

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