GitLab API调用问题：触发Runner执行Job时返回Bad Request如何解决？

你用错了GitLab API接口——jobs/request是GitLab Runner主动向GitLab服务器拉取待执行任务的接口，不是外部调用用来创建Job的，所以直接POST这个接口会返回Bad Request。

正确的做法是通过GitLab的项目Pipeline API来触发任务，让Runner去执行对应的Job。以下是具体修正步骤和代码：

核心修正点 #

• 替换API接口：使用项目Pipeline创建接口 POST /projects/:id/pipeline（:id是项目的ID或路径）
• 添加认证：请求头必须携带具有api权限的私有令牌/访问令牌
• 调整请求参数：GitLab需要指定代码分支（ref），并通过变量传递要执行的命令（前提是项目的.gitlab-ci.yml里有对应的Job配置）

前置准备 #

先确保你的项目.gitlab-ci.yml里有一个可接收变量的Job，比如：

execute_command:
  script:
    - $RUNNER_COMMAND
  tags:
    - 你的runner标签 # 要和目标Runner的标签匹配，确保Runner能接到这个Job
  only:
    - triggers # 或者按需设置触发条件

修正后的代码实现 #

public async Task<string> TriggerRunnerJob(int projectId, string runnerCommand, string branchRef = "main")
{
    try
    {
        // 构建Pipeline请求参数
        var pipelineRequest = new
        {
            ref = branchRef, // 要执行的代码分支/标签
            variables = new[]
            {
                new { key = "RUNNER_COMMAND", value = runnerCommand }
            }
        };

        // 添加GitLab认证头（替换成你的私有令牌）
        _httpClient.DefaultRequestHeaders.Add("PRIVATE-TOKEN", "你的GitLab私有令牌");

        var content = new StringContent(JsonSerializer.Serialize(pipelineRequest), Encoding.UTF8, "application/json");
        var response = await _httpClient.PostAsync($"{_gitLabUrl}/projects/{projectId}/pipeline", content);

        // 读取错误响应详情，方便排查问题
        var responseBody = await response.Content.ReadAsStringAsync();
        if (response.IsSuccessStatusCode)
        {
            return responseBody;
        }
        else
        {
            return $"请求失败，状态码：{(int)response.StatusCode}，详情：{responseBody}";
        }
    }
    catch (Exception ex)
    {
        return $"触发失败：{ex.Message}";
    }
}

额外注意事项 #

• 确保你的GitLab令牌拥有项目的api权限，可以在GitLab个人设置的"访问令牌"里创建
• Runner必须和Job的标签匹配，否则Runner不会接收这个任务
• 如果不想依赖.gitlab-ci.yml的配置，也可以使用GitLab的CI/CD Job触发API（POST /projects/:id/jobs/:job_id/play），但需要先有已存在的Job记录，不如Pipeline方式灵活

内容的提问来源于stack exchange，提问作者Rafał Developer