.NET 8 Blazor WebServer中如何流式转发文件至客户端

要实现无需全量加载到内存的流式转发，核心是调整HttpClient的请求行为，让它在拿到响应头后就返回，而非等待完整响应下载完成，同时确保流能直接传递给客户端。

关键修改步骤 #

1. 调整HttpClient请求模式 #

默认GetAsync会使用HttpCompletionOption.ResponseContentRead，这会把整个响应内容加载到内存中。改为ResponseHeadersRead后，HttpClient会在接收完响应头就立即返回，此时ReadAsStreamAsync得到的是直接连接第三方API的网络流，而非MemoryStream。

2. 修改C#后端代码 #

// stuff
using var client = new HttpClient();
// 使用ResponseHeadersRead选项，避免全量加载响应到内存
var response = await client.GetAsync(url_of_file, HttpCompletionOption.ResponseHeadersRead);
if(response.IsSuccessStatusCode)
{
    // 直接获取网络流，无需缓存到内存
    var stream = await response.Content.ReadAsStreamAsync();
    // 传递流引用给JS
    var streamRef = new DotNetStreamReference(stream: stream);
    await JS.InvokeVoidAsync("downloadFileFromStream", name_of_file, streamRef);
}
// stuff

3. 确保JS端正确处理流式下载 #

对应的downloadFileFromStream函数需要通过流式读取数据，避免一次性加载到客户端内存。示例JS代码：

async function downloadFileFromStream(fileName, streamRef) {
    const stream = await streamRef.stream();
    const blob = new Blob([stream], { type: 'application/octet-stream' });
    const url = URL.createObjectURL(blob);
    
    const a = document.createElement('a');
    a.href = url;
    a.download = fileName;
    document.body.appendChild(a);
    a.click();
    
    URL.revokeObjectURL(url);
    document.body.removeChild(a);
}

注：现代浏览器的Blob构造器支持直接传入ReadableStream，这样客户端也会流式处理数据，进一步降低双方内存占用。

额外注意事项 #

• 确保第三方API的响应支持流式传输（大多数application/octet-stream接口都支持），如果API强制返回完整响应，那这个方法可能不生效，但这种情况极少。
• 务必用using包裹HttpClient和流相关对象，确保资源能被正确释放，避免内存泄漏。
• 并发场景下，这种流式处理能大幅降低服务器内存占用，因为每个请求只需要维护一个网络连接流，而非完整的文件内容。

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