如何使用System.Net.Http.HttpClient获取超大文件？

在.NET 7中，要实现获取超大文件同时查看响应头的需求，核心是避免将整个文件加载到内存，关键操作如下：

• 使用HttpClient.SendAsync()发送请求时，指定HttpCompletionOption.ResponseHeadersRead选项，该选项会让客户端在获取到响应头后立即返回，不会自动下载完整响应体。
• 从返回的HttpResponseMessage中读取响应头信息，再通过Content.ReadAsStreamAsync()获取真正的网络流——这个流不会被缓存到MemoryStream，支持分块读取处理。

示例代码：

using var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://example.com/large-file");

// 仅读取响应头就返回，不等待完整响应体下载
using var response = await httpClient.SendAsync(request, HttpCompletionOption.ResponseHeadersRead);
response.EnsureSuccessStatusCode();

// 读取响应头信息，比如文件大小、内容类型
var contentLength = response.Content.Headers.ContentLength;
var contentType = response.Content.Headers.ContentType;

// 获取可分块读取的网络流
using var responseStream = await response.Content.ReadAsStreamAsync();
// 示例：将流写入本地文件，分块操作避免内存溢出
using var fileStream = new FileStream("large-file.bin", FileMode.Create, FileAccess.Write, FileShare.None, bufferSize: 8192, useAsync: true);

await responseStream.CopyToAsync(fileStream);

关键说明 #

HttpCompletionOption.ResponseHeadersRead是实现的核心，它改变了HttpClient默认下载完整响应体到内存的行为，让响应体流直接关联网络连接，你可以通过CopyToAsync或手动分块读取的方式处理超大文件，全程不会将整个文件加载到内存中。

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