如何用ASP.NET MVC 4.8将Azure存储Blob下载至浏览器（含大文件优化）

你的现有方案存在内存占用过高和冗余操作的问题，尤其是处理4GB级别的大文件时，DownloadContent()和多次ToArray()调用会把整个文件加载到内存，极易引发OutOfMemoryException。下面是针对ASP.NET MVC 4.8（WebForm）的优化方案：

后端服务层优化 #

将返回BlobDownloadResult改为返回流式数据，避免一次性加载整个文件到内存：

public async Task<Stream> Download(string fileName, string containerName)
{
    BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient(containerName);
    BlobClient blobClient = containerClient.GetBlobClient(fileName);
    
    // 打开Blob的只读流，仅在读取时加载数据块，而非全量加载
    return await blobClient.OpenReadAsync();
}

// 新增辅助方法用于获取Blob属性（用于获取ContentType）
public async Task<BlobProperties> GetBlobProperties(string fileName, string containerName)
{
    BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient(containerName);
    BlobClient blobClient = containerClient.GetBlobClient(fileName);
    var properties = await blobClient.GetPropertiesAsync();
    return properties.Value;
}

WebForm页面处理优化 #

去掉冗余的字节数组转换，直接通过流分块写入Response，同时优化响应头设置：

public async void DownloadFileToBrowser()
{
    try
    {
        // 获取Blob属性和流
        var blobProperties = await azStorageBlob.GetBlobProperties(fileName, containerName);
        using (var blobStream = await azStorageBlob.Download(fileName, containerName))
        {
            // 清理响应，避免残留输出
            Response.Clear();
            
            // 使用Blob存储的原始ContentType，而非硬编码
            Response.ContentType = blobProperties.ContentType ?? "application/octet-stream";
            // 设置下载文件名和文件大小
            Response.AddHeader("Content-Disposition", $"attachment; filename=\"{fileName}\"");
            Response.AddHeader("Content-Length", blobProperties.ContentLength.ToString());
            
            // 分块读取写入，避免内存溢出
            byte[] buffer = new byte[32 * 1024]; // 32KB块大小，可根据服务器性能调整
            int bytesRead;
            
            while ((bytesRead = await blobStream.ReadAsync(buffer, 0, buffer.Length)) > 0 && Response.IsClientConnected)
            {
                await Response.OutputStream.WriteAsync(buffer, 0, bytesRead);
                Response.Flush();
            }
        }
    }
    catch (Exception ex)
    {
        // 处理异常，返回错误提示
        Response.Clear();
        Response.ContentType = "text/plain";
        Response.Write($"下载失败：{ex.Message}");
    }
    finally
    {
        Response.End();
    }
}

关键优化点说明 #

1. 避免全量加载文件：改用OpenReadAsync()获取流式数据，仅在读取时加载对应块，4GB文件不会一次性占用内存
2. 移除冗余操作：删除多次ToArray()调用，不再将文件转换为字节数组，减少内存浪费
3. 异步处理：使用async/await提升服务器并发处理能力，避免阻塞线程
4. 正确设置响应头：从Blob元数据获取ContentType，保证浏览器正确识别文件类型；添加Content-Length让浏览器显示下载进度
5. 资源自动释放：用using语句自动管理流资源，避免内存泄漏

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