Jenkins：未设置USER_INPUT_VALUE时绕过Shell变量验证问题

问题场景 #

根据上游${SHOW_OPTION}的YES/NO条件，在Jenkins中通过Groovy设置条件化参数USER_INPUT_VALUE：

if ("$SHOW_OPTION" == ("NO")) {
     properties([ // 不传入用户输入
       ])
else
{
     properties([
       parameters([ string(name: 'USER_INPUT_VALUE', defaultValue: 'mydefault')])
     ])
}

后续在Jenkinsfile中调用Shell脚本赋值变量：

if [ ${SHOW_OPTION} == "NO" ]; then TARGET='"NO_USER_VALUE"'; else TARGET=$USER_INPUT_VALUE; fi;

当SHOW_OPTION为NO时，构建抛出错误：

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

注：该Shell命令在常规Shell环境中运行正常（已通过echo $?验证）。

问题原因 #

Jenkins的Groovy解释器会在执行Shell脚本之前，对整个Jenkinsfile中的变量做预插值替换。也就是说，不管Shell脚本内部的if条件是否成立，Groovy都会先尝试解析$USER_INPUT_VALUE这个变量。当SHOW_OPTION为NO时，你没有定义该参数，Groovy找不到对应的属性，直接抛出异常，根本不会进入Shell脚本的执行阶段。而常规Shell环境没有这个预解析步骤，所以能正常运行。

解决方法 #

方法1：用单引号避免Groovy预解析 #

Jenkins中，单引号包裹的Shell内容不会被Groovy做变量插值，会原封不动传递给Shell执行。你可以：

• 用三单引号包裹整个Shell命令：

'''
if [ ${SHOW_OPTION} == "NO" ]; then TARGET='"NO_USER_VALUE"'; else TARGET=$USER_INPUT_VALUE; fi;
'''

• 或者仅对$USER_INPUT_VALUE用单引号转义：

if [ ${SHOW_OPTION} == "NO" ]; then TARGET='"NO_USER_VALUE"'; else TARGET='$USER_INPUT_VALUE'; fi;

方法2：Groovy层面提前处理变量逻辑 #

在调用Shell之前，先通过Groovy判断SHOW_OPTION的值，提前完成变量赋值，再传入Shell：

def targetValue = SHOW_OPTION == "NO" ? "\"NO_USER_VALUE\"" : USER_INPUT_VALUE
sh "TARGET=${targetValue}; echo \$TARGET"

这种方式把变量判断逻辑放在Groovy中处理，从根源上避免了Shell脚本中未定义变量被预解析的问题。

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