如何在C#应用中调用GitLab API？解决提交获取未授权错误

阿华AIGC实验室

2026-5-28

嘿，我来帮你搞定这两个GitLab API调用的问题！

1. 如何在C#应用程序中调用GitLab API？

调用GitLab API其实没那么复杂，核心步骤我给你梳理得明明白白：

先搞定访问令牌：去GitLab个人设置里生成一个「个人访问令牌（Personal Access Token）」，记得勾选对应权限——比如要读仓库就勾read_repository，要写操作就勾对应的权限。令牌生成后立刻存好，GitLab不会再给你显示第二次。
选个顺手的HTTP客户端：C#里常用的有WebClient（简单直接，适合小场景）和HttpClient（更现代，支持异步，新项目优先选这个）。你用WebClient也完全没问题。
拼对API地址：GitLab API的基础路径是http://你的GitLab域名/api/v4/，所有接口都基于这个前缀。比如获取提交记录的接口是projects/{项目ID}/repository/commits——这里的项目ID可以是数字ID，也可以是URL编码后的项目路径（比如DevOps/WebApp1要转成DevOps%2FWebApp1）。
加授权头发请求：把令牌放到请求头里，GitLab支持两种方式：
- 个人访问令牌常用Private-Token头：client.Headers.Add("Private-Token", "你的令牌");
- OAuth2令牌用Authorization: Bearer 你的令牌
处理JSON响应：API返回的是JSON，你可以用Newtonsoft.Json或者System.Text.Json把它转成C#对象，方便后续操作。

2. 解决调用GitLab API获取提交记录时的未授权错误

看了你的代码，我发现几个可能踩坑的地方，咱们一个个来fix：

坑1：API URL格式完全错了

你用的http://xxxxxx/DevOps/WebApp1.git/repository/commits不对！GitLab API必须用/api/v4/前缀，正确的URL应该是：

http://xxxxxx/api/v4/projects/DevOps%2FWebApp1/repository/commits

注意这几点：

必须加/api/v4/前缀
项目路径里的/要换成%2F（URL编码）
别加.git后缀

坑2：授权头可能和令牌类型不匹配

如果你的令牌是个人访问令牌，GitLab更推荐用Private-Token头，而不是Bearer。当然Bearer也支持，但有时候会因为令牌类型不对导致未授权。先换成Private-Token试试！

坑3：WebClient的BaseAddress设置重复了

你把client.BaseAddress = Url;然后又调用client.DownloadString(Url);，这会导致请求的URL变成Url + Url，相当于重复了两次地址，肯定会报错！要么去掉BaseAddress的设置，要么只把BaseAddress设为API基础路径，然后DownloadString传相对路径。

修正后的代码示例

我给你改好了代码，直接拿去试：

using System.Net;
using System.Web; // .NET Framework用这个；如果是.NET Core/.NET 5+，用System.Web.HttpUtility或者Uri.EscapeDataString

// 1. 构造正确的API地址
string gitLabBaseUrl = "http://xxxxxx/api/v4/";
string projectPath = "DevOps/WebApp1";
// 对项目路径做URL编码
string encodedProjectPath = HttpUtility.UrlEncode(projectPath);
string commitsUrl = $"{gitLabBaseUrl}projects/{encodedProjectPath}/repository/commits";

using (var client = new WebClient())
{
    // 2. 设置授权头（个人访问令牌用Private-Token）
    client.Headers.Add("Private-Token", "你的access token");
    // 告诉服务器我们要JSON格式的响应
    client.Headers.Add(HttpRequestHeader.Accept, "application/json");

    try
    {
        // 3. 发送请求并获取结果
        var commitsJson = client.DownloadString(commitsUrl);
        // 这里可以把JSON转成C#对象，比如用Newtonsoft.Json
        // var commits = JsonConvert.DeserializeObject<List<YourCommitClass>>(commitsJson);
        Console.WriteLine("提交记录获取成功！");
    }
    catch (WebException ex)
    {
        // 捕获错误，看看具体哪里出问题了
        using (var response = ex.Response as HttpWebResponse)
        {
            if (response != null)
            {
                Console.WriteLine($"错误状态码：{(int)response.StatusCode}");
                using (var reader = new StreamReader(response.GetResponseStream()))
                {
                    string errorDetails = reader.ReadToEnd();
                    Console.WriteLine("错误详情：" + errorDetails);
                }
            }
        }
    }
}