Jenkins使用多行参数传递curl选项执行命令报错如何解决？

问题原因 #

• 核心为Shell的单词拆分与引号解析规则导致的参数解析错误：直接使用$CURL_OPTIONS作为curl参数传入时，Shell仅会按空白符拆分字符串，不会识别内容中的单引号、反斜杠等语法符号。手动执行命令时单引号包裹的内容会被识别为单个参数，但变量展开后的单引号仅会被当作普通字符，无法起到参数边界的作用。
• 示例：变量内的'header1: X'展开后会被拆分为'header1:、X'两个独立参数，curl会将X'识别为主机名尝试解析，因此出现未知主机报错。
• 使用tr删除换行和反斜杠的操作仅解决了续行符和换行的问题，没有解决参数拆分的核心逻辑问题，因此仍然报错。
• 传入的参数值中存在HTML转义的"字符，未还原为普通双引号也会导致JSON格式解析错误。

正确实现方式 #

方案1：Bash数组存储参数（适合可信输入场景） #

如果可以保证CURL_OPTIONS的内容均为内部可信配置，可直接用数组解析参数，操作最简单：

sh '''
#!/bin/bash
# 还原转义引号并解析参数到数组
eval "curl_args=($CURL_OPTIONS)"
# 传入数组执行curl
curl "${curl_args[@]}"
'''

方案2：xargs自动处理参数拆分 #

sh '''
echo "$CURL_OPTIONS" | tr -d '\\\n' | sed 's/"/"/g' | xargs curl
'''

该方案会自动处理引号包裹的参数拆分逻辑，同时还原HTML转义的双引号为正常格式。

方案3：curl配置文件调用（生产环境推荐，无注入风险） #

如果担心命令注入风险，可使用curl原生的配置文件参数，完全规避Shell参数拆分问题：

sh '''
# 处理参数：删除续行反斜杠、还原转义引号、过滤空行后写入配置文件
echo "$CURL_OPTIONS" | sed -e 's/\\\\$//' -e 's/"/"/g' | grep -v '^[[:space:]]*$' > curl_config.txt
# 指定配置文件执行curl
curl -K curl_config.txt
# 清理临时文件
rm -f curl_config.txt
'''

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