GitLab CI中curl命令变量无法替换的问题求助

方案1：调整Header的引号写法 #

将Header部分的双引号改为单引号包裹固定文本、双引号包裹变量的组合，避免shell解析时的变量替换异常：

create_changelog:
  stage: create_changelog
  variables:
    REDMINE_API_KEY: "cbf456d6c74ae85bfbcddfd130c75af4f0977448"
  script:
    - |
      curl -X PUT \
      "https://redmine.example.com/projects/flutter-2/wiki/abc1.xml" \
      -H "cache-control: no-cache" \
      -H "content-type: application/xml" \
      -H 'x-redmine-api-key: '"${REDMINE_API_KEY}"'' \
      -d "<?xml version=\"1.0\"?><wiki_page><text>Example</text><parent title=\"Release\"/></wiki_page>"

原理：单引号内的内容会被shell原样保留，拼接的双引号包裹变量则会被正常解析替换，确保API Key能正确传入请求Header。

方案2：先验证变量是否正常传递 #

在curl命令前添加echo语句，确认变量值是否被正确加载，排除变量未定义的问题：

create_changelog:
  stage: create_changelog
  variables:
    REDMINE_API_KEY: "cbf456d6c74ae85bfbcddfd130c75af4f0977448"
  script:
    - echo "当前API Key：${REDMINE_API_KEY}" # 验证变量值是否正确
    - |
      curl -X PUT \
      "https://redmine.example.com/projects/flutter-2/wiki/abc1.xml" \
      -H "cache-control: no-cache" \
      -H "content-type: application/xml" \
      -H "x-redmine-api-key: ${REDMINE_API_KEY}" \
      -d "<?xml version=\"1.0\"?><wiki_page><text>Example</text><parent title=\"Release\"/></wiki_page>"

如果echo输出为空或不符合预期，需检查变量定义的拼写、YAML格式是否存在错误。

方案3：简化变量引用语法 #

部分场景下，使用$REDMINE_API_KEY（不带大括号）也能正常完成替换，可尝试简化写法：

-H "x-redmine-api-key: $REDMINE_API_KEY"

额外注意事项 #

• 若API Key包含特殊字符（如空格、&等），必须用双引号包裹变量，避免shell解析错误。
• 若变量是项目/群组级的受保护变量，需确保Job运行的分支/标签符合受保护规则，否则变量无法被正常访问。

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