C#如何实现支持multipart/byteranges的HTTP分块下载文件服务器？

HTTP协议中的范围请求机制允许客户端只请求服务器端文件的一部分内容，这在实现大文件断点续传或视频流媒体播放时极为关键。当客户端需要同时请求多个不连续的文件片段时，服务器需要返回包含多个字节范围的响应体，此时响应的Content-Type必须设置为multipart/byteranges。在C#中构建支持该特性的文件服务器，需要深入理解HTTP协议规范并精确控制底层文件流与网络流的交互。

理解HTTP范围请求与multipart/byteranges机制

HTTP范围请求的核心在于请求头Range。当客户端发送Range: bytes=0-499,1000-1499时，表示需要获取文件的第0到499字节以及第1000到1499字节。服务器在处理这种多范围请求时，不能简单返回单个字节流，而是需要使用特定的边界字符串将多个响应片段分隔开。

对于多范围请求，服务器的响应状态码应为206 Partial Content。响应头中的Content-Type必须设置为multipart/byteranges; boundary=BOUNDARY_STRING。响应体则由多个部分组成，每个部分包含自己的Content-Type和Content-Range头，以及实际的数据块，各部分之间通过--BOUNDARY_STRING进行分隔，并在结尾处使用--BOUNDARY_STRING--表示结束。

理解这一结构是编写C#文件服务器的基础。如果边界字符串处理不当，或者Content-Range格式不规范，客户端将无法正确解析接收到的数据，导致下载失败或文件损坏。因此，必须严格按照RFC规范组装响应数据。

在C#中解析Range请求头并定位文件流

在C#中实现文件服务器的第一步是准确解析客户端发送的Range请求头。通常可以使用ASP.NET Core的中间件或HttpHandler来拦截请求。解析过程需要处理字符串提取、分割以及整数转换等操作，同时还要考虑边界情况，例如请求范围超出文件实际大小的情况。

下面是一个解析Range头的代码示例。该代码将字符串形式的范围转换为包含起始和结束位置的元组列表。如果解析失败，则返回空列表，服务器可以据此决定是返回完整文件还是400错误。

// C# 解析Range请求头示例
private static List<(long Start, long End)> ParseRangeHeader(string rangeHeader, long fileLength)
{
    var ranges = new List<(long Start, long End)>();
    if (string.IsNullOrWhiteSpace(rangeHeader) || !rangeHeader.StartsWith("bytes="))
    {
        return ranges;
    }

    var rangeSpec = rangeHeader.Substring(6);
    var parts = rangeSpec.Split(',');
    foreach (var part in parts)
    {
        var bounds = part.Trim().Split('-');
        if (bounds.Length == 2)
        {
            long start = 0, end = 0;
            if (string.IsNullOrEmpty(bounds[0]))
            {
                // 处理 -500 这种情况，表示最后500字节
                start = fileLength - long.Parse(bounds[1]);
                end = fileLength - 1;
            }
            else if (string.IsNullOrEmpty(bounds[1]))
            {
                // 处理 1000- 这种情况，表示从1000到末尾
                start = long.Parse(bounds[0]);
                end = fileLength - 1;
            }
            else
            {
                start = long.Parse(bounds[0]);
                end = long.Parse(bounds[1]);
            }

            if (start < 0) start = 0;
            if (end >= fileLength) end = fileLength - 1;

            if (start <= end)
            {
                ranges.Add((start, end));
            }
        }
    }
    return ranges;
}

解析出范围后，服务器需要使用FileStream打开目标文件。通过FileStream.Seek方法将文件指针移动到指定的起始位置，然后读取指定长度的字节。在处理多个范围时，需要循环执行定位和读取操作，确保每个片段的数据都能被准确提取。

构建multipart/byteranges响应体与边界处理

当解析出多个范围请求后，服务器需要生成一个唯一的边界字符串，通常使用Guid来保证唯一性。随后，需要设置HTTP响应的状态码为206，并配置Content-Type为multipart/byteranges，同时附带边界字符串。

在写入响应体时，必须严格按照HTTP协议规范拼接字符串。每个范围片段前需要加上--BOUNDARY，接着是片段的头部信息（如Content-Type和Content-Range），然后是一个空行，接着是实际的二进制数据，最后再跟一个空行。所有片段写完后，需要加上--BOUNDARY--表示响应体结束。

// C# 构建multipart响应体核心逻辑
public static async Task WriteMultipartResponseAsync(HttpContext context, string filePath, List<(long Start, long End)> ranges, long fileLength)
{
    var boundary = "BOUNDARY_" + Guid.NewGuid().ToString("N");
    context.Response.StatusCode = 206;
    context.Response.ContentType = "multipart/byteranges; boundary=" + boundary;

    using var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read);
    foreach (var range in ranges)
    {
        // 写入边界和片段头部
        await context.Response.WriteAsync($"--{boundary}\r\n");
        await context.Response.WriteAsync($"Content-Type: application/octet-stream\r\n");
        await context.Response.WriteAsync($"Content-Range: bytes {range.Start}-{range.End}/{fileLength}\r\n\r\n");

        // 写入实际文件数据
        fileStream.Seek(range.Start, SeekOrigin.Begin);
        byte[] buffer = new byte[4096];
        long bytesToRead = range.End - range.Start + 1;
        while (bytesToRead > 0)
        {
            int readCount = await fileStream.ReadAsync(buffer, 0, (int)Math.Min(buffer.Length, bytesToRead));
            if (readCount == 0) break;
            await context.Response.Body.WriteAsync(buffer, 0, readCount);
            bytesToRead -= readCount;
        }
        await context.Response.WriteAsync("\r\n");
    }
    // 写入结束边界
    await context.Response.WriteAsync($"--{boundary}--\r\n");
}

在上述代码中，为了防止大文件导致内存溢出，并没有一次性将整个文件或整个范围的数据读入内存，而是使用了一个固定大小的缓冲区进行循环读取和写入。这种流式处理方式极大地降低了服务器的内存占用，使得即使在处理高并发的大文件下载请求时，服务器也能保持稳定运行。

完整的C#文件服务器实现与测试验证

将上述解析和响应构建逻辑整合到一个ASP.NET Core中间件中，即可实现一个完整的支持multipart/byteranges的文件服务器。中间件需要拦截特定的下载路径，检查请求头中是否包含Range字段，并根据解析结果决定走单范围响应逻辑还是多范围响应逻辑。

在实际测试中，可以使用工具如Postman或cURL来发送带有多个范围的请求。例如，使用命令curl -H "Range: bytes=0-100,200-300" http://127.0.0.1:5000/download/test.zip -o output.txt，然后检查返回的状态码是否为206，以及响应体是否包含正确的边界字符串和文件数据。如果一切正常，客户端可以将接收到的多部分响应重新组装成完整的文件片段。

需要注意的是，虽然HTTP协议支持多范围请求，但在实际应用中，单范围请求（断点续传）更为常见。因此，服务器在实现时也应优化单范围请求的处理路径，直接返回Content-Range而不使用边界字符串。此外，对于不支持范围请求的客户端，服务器应能优雅降级，直接返回200状态码和完整文件流。

C#HTTP分块下载multipart/byteranges修改时间：2026-08-23 03:16:45