使用GitLab API（curl）更新CI/CD变量时遭遇401未授权错误

问题排查与修复方案 #

1. 放弃使用CI_JOB_TOKEN #

CI_JOB_TOKEN仅具备有限的项目操作权限，默认无法修改项目级CI/CD变量。该令牌仅适用于CI作业内部的基础操作（如拉取代码、上传制品），用它调用变量更新API必然返回401，直接排除这种方式即可。

2. 修正PRIVATE-TOKEN的格式错误 #

你第二个curl命令里的PRIVATE-TOKEN:\ $token多了一个不必要的反斜杠，会导致令牌被错误解析。正确格式参考第三个命令：

NEW_VERSION="1234"
curl --request PUT --header "PRIVATE-TOKEN: $token" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/variables/TEST" --form "value=$NEW_VERSION"

3. 确认访问令牌的权限配置 #

即使你是Maintainer角色，创建访问令牌时必须勾选对应权限：

• 必须勾选**"API"**权限
• 确保令牌关联的角色为Maintainer或更高等级（你已满足角色要求，重点确认权限勾选）

4. 验证参数正确性 #

• 执行curl前先打印echo $token，确认令牌内容完整无多余空格
• 核对$CI_PROJECT_ID是否与GitLab项目「设置→通用」中显示的项目ID一致
• 确认变量名TEST已存在于项目CI/CD变量列表（若创建新变量，需改用POST请求而非PUT）

5. 开启调试模式定位问题 #

若仍未解决，添加-v参数查看详细请求/响应头，进一步排查权限细节：

curl -v --request PUT --header "PRIVATE-TOKEN: $token" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/variables/TEST" --form "value=$NEW_VERSION"

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