Jenkinsfile Groovy闭包布尔参数默认值为何始终为null？

我给Jenkins的sh任务写了个包装闭包，用来捕获stderr并打印到日志里，但遇到个问题——布尔类型的参数，除非显式传入true或false，否则默认值总是null。

调用示例如下（注：pytest是一个用来构建pytest运行命令并返回字符串的闭包）：

def sh_stdout = sh_wrap(pytest("some args to a closure called pytest", "more args"))

sh包装闭包的代码片段：

sh_wrap = { String cmd, Boolean print_to_log = true, Boolean capture_stdout = true, Boolean capture_stderr = false ->
    echo "cmd ${cmd}"
    echo "print_to_log ${print_to_log}"
    echo "capture_stdout ${capture_stdout}"
    echo "capture_stderr ${capture_stderr}"
    if(capture_stderr) {
        cmd += ' 2>&1'
    }
    sh_stdout = sh(script: cmd, returnStdout: capture_stdout)
    if(print_to_log) {
        echo sh_stdout
    }
    return sh_stdout
}

问题原因 #

在Groovy闭包中，当仅传递第一个cmd参数时，后续布尔参数并未正确触发默认值赋值，反而被设为null。这是因为Groovy对闭包默认参数的解析依赖于参数传递方式——如果不使用命名参数或严格按顺序传参，默认值逻辑可能失效。

解决办法 #

1. 用命名参数调用闭包

调用时明确指定cmd参数名，确保后续布尔参数的默认值正常生效：

def sh_stdout = sh_wrap(cmd: pytest("some args to a closure called pytest", "more args"))

2. 在闭包内部添加空值兜底处理

即使参数传入null，也通过逻辑判断替换为预设的默认值，修改后的闭包代码：

sh_wrap = { String cmd, Boolean print_to_log = true, Boolean capture_stdout = true, Boolean capture_stderr = false ->
    // 空值兜底，确保参数始终为布尔值
    print_to_log = print_to_log != null ? print_to_log : true
    capture_stdout = capture_stdout != null ? capture_stdout : true
    capture_stderr = capture_stderr != null ? capture_stderr : false
    
    echo "cmd ${cmd}"
    echo "print_to_log ${print_to_log}"
    echo "capture_stdout ${capture_stdout}"
    echo "capture_stderr ${capture_stderr}"
    if(capture_stderr) {
        cmd += ' 2>&1'
    }
    def sh_stdout = sh(script: cmd, returnStdout: capture_stdout)
    if(print_to_log) {
        echo sh_stdout
    }
    return sh_stdout
}

也可以用Groovy的Elvis运算符简化：print_to_log = print_to_log ?: true，这种写法在参数被显式传入false时也能正确保留值。

3. 严格按参数顺序传递（不推荐）

如果不想用命名参数，调用时可以显式传递后续参数的默认值，但这种写法灵活性差：

def sh_stdout = sh_wrap(pytest("some args to a closure called pytest", "more args"), true, true, false)

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