GitLab Pipeline中如何向curl传递含多参数的字符串变量？

在GitLab流水线的YAML配置里，若想把curl命令中重复的参数片段抽出来复用，直接将参数存为字符串变量的方式会导致curl执行失败。比如你原本的完整curl命令能正常运行：

curl --location ${OAUTH_URL} --header 'Accept:application/json' --header "x-api-key:${AUTH_CACHING_API_KEY}" --data-urlencode "partition=${PARTITION_ID}" --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode "audience=${OAUTH_AUDIENCE}"

但把部分参数存入CURL_EXTRA_PARAMS变量后再传递给curl，命令就会报错：

CURL_EXTRA_PARAMS=" --header 'Accept:application/json' --header \"x-api-key:${AUTH_CACHING_API_KEY}\" --data-urlencode \"partition=${PARTITION_ID}\""

curl --location ${OAUTH_URL} "${CURL_EXTRA_PARAMS}" --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode "audience=${OAUTH_AUDIENCE}"

这是因为shell会把整个字符串变量当成curl的单个参数，而非拆分后的多个独立参数，导致curl无法识别这些选项。下面是两种通用解决方案：

方案一：用Bash数组存储多参数 #

Bash数组可以将每个curl参数作为独立元素存储，调用时展开数组就能让curl正确识别每个参数：

# 定义参数数组，每个参数单独一行更清晰
CURL_EXTRA_PARAMS=(
  --header 'Accept:application/json'
  --header "x-api-key:${AUTH_CACHING_API_KEY}"
  --data-urlencode "partition=${PARTITION_ID}"
)

# 调用curl时用@符号展开数组，确保每个元素都是独立参数
curl --location "${OAUTH_URL}" "${CURL_EXTRA_PARAMS[@]}" --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode "audience=${OAUTH_AUDIENCE}"

方案二：用GitLab YAML锚点跨job复用 #

如果需要在流水线的多个job里复用同一套curl参数，直接用GitLab支持的YAML锚点特性更方便，无需依赖shell变量：

# 定义可复用的参数锚点，前缀加.表示这是隐藏的模板
.curl_common_params: &curl_common_params
  --header 'Accept:application/json'
  --header "x-api-key:${AUTH_CACHING_API_KEY}"
  --data-urlencode "partition=${PARTITION_ID}"

# 第一个job引用锚点
job1:
  script:
    - curl --location "${OAUTH_URL}" *curl_common_params --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode "audience=${OAUTH_AUDIENCE}"

# 第二个job同样引用锚点，搭配其他参数
job2:
  script:
    - curl --location "${ANOTHER_API_URL}" *curl_common_params --data-urlencode "other_param=${OTHER_VALUE}"

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