GitLab API创建Release关联资产时curl命令格式错误排查求助

云原生阿岚

2026-7-22

问题原因

你的curl命令报错是因为shell错误解析了JSON中的特殊字符：bash会将未被正确引用的大括号{}识别为 brace expansion 语法，而非字符串的一部分，导致curl把JSON片段误当作URL处理，同时引号混用也加剧了解析混乱。

修正方案

以下两种方法均可解决问题，推荐第二种更简洁可靠：

方法1：转义JSON内部双引号，用双引号包裹整个请求体

将--data参数内的所有双引号转义，确保shell不会拆分JSON内容：

curl --header 'Content-Type: application/json' --header "PRIVATE-TOKEN: myTokenHere" --data "{ \"name\": \"2.0.0.0\", \"tag_name\": \"1.0.0.0\", \"description\": \"Release manually created from API\", \"assets\": { \"links\": [{ \"name\": \"Release_1.2.0.0\", \"url\": \"https://my.gitlab.space/api/v4/projects/197/packages/generic/my_package_registry_2.0.4.0/1.0.0.0/myZipFile.zip\", \"link_type\":\"package\" }] } }" --request POST "https://my.gitlab.space/api/v4/projects/197/releases"

方法2：将JSON写入文件，通过文件传递请求体（推荐）

这种方法完全规避shell解析问题，更易维护：

创建release_payload.json文件，内容如下：

{
  "name": "2.0.0.0",
  "tag_name": "1.0.0.0",
  "description": "Release manually created from API",
  "assets": {
    "links": [
      {
        "name": "Release_1.2.0.0",
        "url": "https://my.gitlab.space/api/v4/projects/197/packages/generic/my_package_registry_2.0.4.0/1.0.0.0/myZipFile.zip",
        "link_type": "package"
      }
    ]
  }
}

执行curl命令，用@指定文件路径：

curl --header 'Content-Type: application/json' --header "PRIVATE-TOKEN: myTokenHere" --data @release_payload.json --request POST "https://my.gitlab.space/api/v4/projects/197/releases"

额外检查点