使用HttpWebRequest调用Gitlab API上传大文件流报错如何解决

• 你所使用的Gitlab Repository Files 原生接口存在硬限制：单文件最大仅支持上传10MB，部分自建实例会将阈值下调到1MB，超过上限请求会直接被服务端中断，这是你收到响应提前结束报错的核心原因。
• 参数传递逻辑不符合接口规范：该接口的content参数需要放在URL查询串或者JSON格式的请求体中，你在查询串中传空content值，请求体直接发送base64字符串未做键值对封装，且Content-Type声明为表单格式但实际内容不匹配，服务端解析失败直接断开连接。
• 违反HTTP协议规范：你同时设置了互斥的Transfer-Encoding: chunked请求头和ContentLength属性，导致服务端无法正常解析请求。

方案1：文件≤10MB 修正请求逻辑（适配现有代码框架） #

直接将所有业务参数放到JSON请求体中，不要放在URL里，修正后代码如下：

using System.Net;
using System.IO;
using System.Text;
...
public static void UploadSmallFile(String id, String out_file, String base64Content, string token)
{
    // 文件路径需要先做URL编码，避免特殊字符导致路径解析失败
    string encodedFilePath = Uri.EscapeDataString(out_file);
    string url = $"https://gitlab.xxx/api/v4/projects/{id}/repository/files/{encodedFilePath}";
    
    HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
    request.Method = "POST"; // 新增文件用POST，更新已有文件用PUT
    request.Headers.Add("PRIVATE-TOKEN", token);
    request.ContentType = "application/json";
    request.Proxy = null;

    // 构造符合接口要求的JSON请求体
    string jsonBody = $$"""
    {
        "branch": "master",
        "commit_message": "test",
        "content": "{{base64Content}}",
        "encoding": "base64"
    }
    """;
    byte[] buffer = Encoding.UTF8.GetBytes(jsonBody);
    request.ContentLength = buffer.Length;
    
    using (var reqStream = request.GetRequestStream())
    {
        reqStream.Write(buffer, 0, buffer.Length);
    }

    using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
    using (var reader = new StreamReader(response.GetResponseStream()))
    {
        string output = reader.ReadToEnd();
        Console.WriteLine(output);
    }
}

方案2：文件＞10MB 使用Commits批量提交接口 #

Gitlab Commits接口默认支持单文件最大50MB（可通过实例配置上调阈值），支持同时提交多个文件，适配大文件场景，代码示例：

public static void UploadLargeFile(String id, String out_file, String base64Content, string token)
{
    string url = $"https://gitlab.xxx/api/v4/projects/{id}/repository/commits";
    
    HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
    request.Method = "POST";
    request.Headers.Add("PRIVATE-TOKEN", token);
    request.ContentType = "application/json";
    request.Proxy = null;

    string jsonBody = $$"""
    {
        "branch": "master",
        "commit_message": "upload large file",
        "actions": [
            {
                "action": "create", // 若为更新已有文件，此处改为update
                "file_path": "{{out_file}}",
                "content": "{{base64Content}}",
                "encoding": "base64"
            }
        ]
    }
    """;
    byte[] buffer = Encoding.UTF8.GetBytes(jsonBody);
    request.ContentLength = buffer.Length;
    
    using (var reqStream = request.GetRequestStream())
    {
        reqStream.Write(buffer, 0, buffer.Length);
    }

    using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
    using (var reader = new StreamReader(response.GetResponseStream()))
    {
        string output = reader.ReadToEnd();
        Console.WriteLine(output);
    }
}

• 如果文件大小超过50MB，建议使用Git LFS上传，或直接通过Git命令行提交推送
• 若使用自建Gitlab实例，需要确认反向代理层的上传大小限制是否已经放开，避免中间节点拦截大文件请求

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