如何在Bash脚本中验证Jenkins Pipeline参数？报错排查与语法指导

错误原因 #

1. Groovy与Bash变量隔离：Jenkins Pipeline里的params.BUILD_TYPE是Groovy层面的变量，Bash脚本无法直接识别Groovy的语法结构，Bash会把params.BUILD_TYPE当成不符合规则的变量名，从而抛出bad substitution错误。
2. Bash赋值语法错误：你写的Debug = true是错误的，Bash变量赋值时等号两边不能有空格，正确写法应为Debug=true。

正确写法 #

方法1：将Groovy参数传递给Bash变量 #

在Pipeline的sh步骤中，通过Groovy字符串插值把参数值传入Bash环境，让Bash能识别变量：

pipeline {
    agent any
    parameters {
        choice(name: 'BUILD_TYPE', choices: ['Debug', 'Release'], description: '选择构建类型')
    }
    stages {
        stage('处理构建类型') {
            steps {
                sh """
                    #!/bin/bash
                    # 接收Groovy传递的参数
                    BUILD_TYPE="${params.BUILD_TYPE}"
                    if [ "\$BUILD_TYPE" = "Debug" ]; then
                        Debug=true
                        Release=false
                    else
                        Debug=false
                        Release=true
                    fi
                    # 验证变量
                    echo "当前Debug状态：\$Debug，Release状态：\$Release"
                """
            }
        }
    }
}

注意：用双引号包裹Groovy字符串时，Bash里的$要转义为\$，避免被Groovy提前解析。

方法2：Groovy层面先处理逻辑，再传结果给Bash #

如果逻辑简单，可以先在Groovy中完成参数判断，再把结果传递给Bash：

pipeline {
    agent any
    parameters {
        choice(name: 'BUILD_TYPE', choices: ['Debug', 'Release'], description: '选择构建类型')
    }
    stages {
        stage('处理构建类型') {
            steps {
                script {
                    def isDebug = params.BUILD_TYPE == 'Debug'
                    def isRelease = !isDebug
                    sh """
                        #!/bin/bash
                        Debug=${isDebug}
                        Release=${isRelease}
                        echo "当前Debug状态：\$Debug，Release状态：\$Release"
                    """
                }
            }
        }
    }
}

额外注意事项 #

• Bash变量赋值时，等号两边绝对不能有空格，否则会被Bash当成命令执行，引发新的错误。
• 若在script块中单独编写Bash脚本，同样要注意Groovy与Bash的变量隔离，必须通过字符串插值或参数传递的方式，把Groovy变量传入Bash环境。

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