Jenkinsfile函数中环境变量判断不生效的问题排查

问题根源 #

1. 空值判断逻辑错误：判断始终不成立，大概率是对Jenkins环境变量的空值判断方式有误。比如传递的branch_my是空字符串（而非null）时，若用if (env.branch_my != null)会直接跳过判断；或是没处理全空格参数的情况，导致有效分支名被误判为空。
2. 错误使用${}插值：Groovy的条件语句中不需要用${}包裹变量，${}仅适用于字符串插值场景（比如echo "${env.branch_my}"）。在if判断里写${env.branch_my}会被Jenkins Pipeline当作DSL方法调用，因此抛出“No such DSL method "$" found”错误。

修正后的代码示例 #

def customBranches() {
    // 安全判断变量存在、非空且非全空格
    if (env.branch_my?.trim()) {
        switch_to(env.branch_my)
    }
}

关键细节说明 #

• ?.是Groovy的安全导航操作符：如果env.branch_my为null，会直接返回false，避免调用trim()时抛出空指针异常。
• trim()用于过滤全空格的无效参数：确保只有真正包含分支名内容的参数才会触发switch_to命令。
• 若不需要处理全空格场景，直接用if (env.branch_my)即可：Groovy中空字符串、null、false都会被视为假值，能覆盖大部分空参数情况。

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