如何在ASP.NET Core中返回HttpClient下载流而不占用内存？

我有一个Web API端点，通过先下载文件再返回字节数组的方式提供文件服务。当前代码可正常运行，但会将整个文件（无论大小）加载到内存中。我能否直接返回使用HttpClient下载文件时的同一流？

可正常运行的现有代码 #

[HttpGet("file")]
public async Task<IActionResult> DownloadFile(string url)
{
    using var httpClient = new HttpClient();
    using var response = await httpClient.GetAsync(url);
    if (response.IsSuccessStatusCode)
    {
        var content = await response.Content.ReadAsByteArrayAsync();

        var cd = new System.Net.Mime.ContentDisposition
        {
             FileName = "myFile.pdf",

             // 始终提示用户下载，设为true则让浏览器尝试内嵌显示文件
             Inline = false, 
        };
                
        Response.Headers.Add("Content-Disposition", cd.ToString());
                
        var mediaType = response.Content.Headers.ContentType.MediaType;

        return File(content, mediaType);
    }

    return NotFound();
}

尝试过的代码（抛出异常） #

using var httpClient = new HttpClient();
using var response = await httpClient.GetAsync(url);
if (response.IsSuccessStatusCode)
{
   using (var content = await response.Content.ReadAsStreamAsync())
   {
      content.Position = 0;

      var cd = new System.Net.Mime.ContentDisposition
      {
         FileName = "myFile.pdf",

         // 始终提示用户下载，设为true则让浏览器尝试内嵌显示文件
         Inline = false,
      };

      Response.Headers.Add("Content-Disposition", cd.ToString());

      var mediaType = response.Content.Headers.ContentType.MediaType;

      return File(content, mediaType);
   }
}

这段代码抛出ObjectDisposedException: cannot access a closed stream异常。

解决方案 #

问题根源 #

你用using包裹了流对象，当代码退出using代码块时，流会被自动释放。但ASP.NET Core需要在后续处理响应的阶段访问这个流，因此会触发已释放对象的异常。

修正后的代码 #

// 通过构造函数注入HttpClient（ASP.NET Core最佳实践）
private readonly HttpClient _httpClient;

public YourController(HttpClient httpClient)
{
    _httpClient = httpClient;
}

[HttpGet("file")]
public async Task<IActionResult> DownloadFile(string url)
{
    // 使用ResponseHeadersRead选项，接收完响应头就开始处理，无需等待整个文件下载完成
    var response = await _httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
    if (response.IsSuccessStatusCode)
    {
        var contentStream = await response.Content.ReadAsStreamAsync();

        var cd = new System.Net.Mime.ContentDisposition
        {
            FileName = "myFile.pdf",
            Inline = false // 提示用户下载，设为true则尝试内嵌显示
        };
                
        Response.Headers.Add("Content-Disposition", cd.ToString());
                
        var mediaType = response.Content.Headers.ContentType.MediaType;

        // 直接返回流，ASP.NET Core会在响应发送完成后自动释放流
        return File(contentStream, mediaType);
    }

    return NotFound();
}

关键优化点 #

• 移除流的using声明：ASP.NET Core的File方法会负责在响应处理完成后释放流资源，无需手动管理。
• 注入HttpClient：避免在方法内重复创建HttpClient导致的Socket资源耗尽问题，这是ASP.NET Core的官方推荐做法。
• 使用HttpCompletionOption.ResponseHeadersRead：让HttpClient在接收到响应头后立即返回，无需等待整个文件下载完毕，进一步降低内存占用，提升响应速度。
• 无需设置流位置：从HttpClient获取的流初始位置默认就是0，无需手动设置content.Position = 0。

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