C#中如何将API返回的HttpResponse StreamContent转为Zip文件并下载?
没问题!我来帮你搞定在C#里调用这个返回Stream Content的API、下载Zip文件的实现~
首先先提个小细节:你提供的API代码里ContentType没写完,建议补全为application/zip,这样客户端能更准确识别内容类型,避免潜在的兼容性问题:
result.Content.Headers.ContentType = new MediaTypeHeaderValue("application/zip");
接下来是客户端的具体实现,我们用.NET标准的HttpClient来处理,下面是两种常用的方案:
推荐:异步下载并保存到本地
这是现代.NET项目的首选方式,不会阻塞主线程,处理大文件也更高效:
using System.Net.Http; using System.IO; using System.Threading.Tasks; public async Task DownloadZipFromApiAsync(string apiEndpoint, string saveDirectory) { // 初始化HttpClient(实际项目中建议复用单例HttpClient,不要每次创建) using var httpClient = new HttpClient(); // 发起请求,指定ResponseHeadersRead选项,避免一次性加载整个响应到内存 using var response = await httpClient.GetAsync(apiEndpoint, HttpCompletionOption.ResponseHeadersRead); // 确保请求成功,否则会抛出HttpRequestException response.EnsureSuccessStatusCode(); // 从响应头获取API返回的文件名(如果不需要可以直接用自定义文件名) var contentDisposition = response.Content.Headers.ContentDisposition; var targetFileName = contentDisposition?.FileName ?? "downloaded.zip"; var fullSavePath = Path.Combine(saveDirectory, targetFileName); // 将响应流写入本地文件 await using var responseStream = await response.Content.ReadAsStreamAsync(); await using var fileStream = new FileStream(fullSavePath, FileMode.Create, FileAccess.Write, FileShare.None); await responseStream.CopyToAsync(fileStream); }
同步下载(适合老项目或简单场景)
如果你的项目还在使用同步代码,也可以这样实现:
using System.Net.Http; using System.IO; public void DownloadZipFromApi(string apiEndpoint, string saveDirectory) { using var httpClient = new HttpClient(); // 同步获取响应,注意.Result会阻塞线程 using var response = httpClient.GetAsync(apiEndpoint, HttpCompletionOption.ResponseHeadersRead).Result; response.EnsureSuccessStatusCode(); var contentDisposition = response.Content.Headers.ContentDisposition; var targetFileName = contentDisposition?.FileName ?? "downloaded.zip"; var fullSavePath = Path.Combine(saveDirectory, targetFileName); using var responseStream = response.Content.ReadAsStreamAsync().Result; using var fileStream = new FileStream(fullSavePath, FileMode.Create, FileAccess.Write, FileShare.None); responseStream.CopyTo(fileStream); }
几个关键注意事项:
- 复用HttpClient:上面的示例为了简洁每次创建HttpClient,但实际生产环境中建议复用单例HttpClient,避免创建过多TCP连接。
- ResponseHeadersRead选项:这个选项非常重要,它让HttpClient在拿到响应头后就返回,而不是等整个Zip文件下载完成,能有效降低内存占用,尤其适合大文件。
- 资源释放:所有流和HttpClient都放在
using块中,确保资源被正确释放,避免内存泄漏。 - 异常处理:示例中用
EnsureSuccessStatusCode()处理请求失败,你可以根据自己的需求添加更细致的异常捕获逻辑。
内容的提问来源于stack exchange,提问作者Ayush
相关产品推荐
相关产品推荐

