Jenkins Pipeline中curl调用SonarQube的命令解析问题排查

核心原因 #

这个报错本质是Windows cmd的特殊字符解析规则，和Groovy字符串插值的转义逻辑冲突导致的：

1. Windows cmd里，&是命令分隔符，直接写在参数里会被cmd当成要执行下一个命令，而不是参数的一部分。
2. Groovy的字符串处理和cmd的引号/转义规则不兼容：你尝试的单双引号组合，要么被Groovy提前插值拆分，要么传递给cmd后，cmd无法正确识别参数边界，把引号或者拆分后的片段当成了独立命令，就出现了'"' 未被识别...的错误——说白了就是cmd把本该是参数的引号，当成了要执行的命令名。

常见的转义误区 #

• 用单引号包裹参数：Groovy里单引号是纯字符串常量，但Windows cmd不把单引号当作参数的边界标记，所以单引号会被直接当作参数的一部分传递，导致cmd解析混乱。
• 只用Groovy的\转义双引号：Groovy里\"是转义双引号，但cmd的转义符是^，这种转义方式传递给cmd后完全不生效，反而会多出多余的字符。

可行的解决方法 #

1. 给&添加cmd专属转义符 #

在tools_params里的每个&前面加上^（cmd的转义符），注意Groovy里要把^转义成\\^（因为Groovy本身会解析\，所以需要双重转义）：

environment {
    tools_params = "key1=val1\\^&key2=val2\\^&key3=val3"
}

2. 用三重双引号包裹bat命令 #

配合Groovy的三重双引号（"""）来定义bat脚本，确保变量插值后，cmd能正确识别完整参数：

steps {
    bat """
        curl "http://your-api-url?${tools_params}"
    """
}

这样cmd会把整个URL（包括转义后的&）当作一个完整参数处理，不会拆分命令。

3. 直接用数组形式传递参数（更可靠） #

如果参数特别复杂，建议用bat的数组参数形式，完全避开字符串转义问题：

steps {
    bat(
        script: 'curl "%1"',
        args: "http://your-api-url?${tools_params.replace('&', '^&')}"
    )
}

这里用replace把所有&替换成^&，再通过args传递，cmd会自动正确解析参数。

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