ASP.NET Core中Azure Blob Storage文件下载：路径、MIME类型及下载提示

一、替代FileStream.OpenWrite的正确方案 #

FileStream.OpenWrite依赖本地文件路径，但下载Azure Blob完全不需要本地文件中转，直接通过BlobClient的OpenReadAsync获取远程流即可，跳过本地IO操作。

核心代码示例（基于MemoryStream实现下载） #

public async Task<IActionResult> DownloadBlob(string blobName)
{
    // 初始化BlobClient（可通过依赖注入或配置文件获取连接字符串）
    var blobServiceClient = new BlobServiceClient("你的Azure存储连接字符串");
    var blobContainerClient = blobServiceClient.GetBlobContainerClient("目标容器名");
    var blobClient = blobContainerClient.GetBlobClient(blobName);

    // 校验Blob是否存在
    if (!await blobClient.ExistsAsync())
    {
        return NotFound();
    }

    // 将Blob流复制到MemoryStream
    using var blobStream = await blobClient.OpenReadAsync();
    var memoryStream = new MemoryStream();
    await blobStream.CopyToAsync(memoryStream);
    memoryStream.Position = 0; // 重置流指针到起始位置

    // 获取或指定Blob的MIME类型
    var blobProperties = await blobClient.GetPropertiesAsync();
    var contentType = blobProperties.Value.ContentType;
    // 如果上传时未设置ContentType，手动指定.odt对应的类型
    if (string.IsNullOrEmpty(contentType))
    {
        contentType = "application/vnd.oasis.opendocument.text";
    }

    // 返回流并指定下载文件名
    return File(memoryStream, contentType, blobName);
}

二、解决文件名与下载提示问题 #

1. 指定正确MIME类型：.odt对应的标准MIME类型是application/vnd.oasis.opendocument.text，如果上传时未给Blob设置ContentType，下载时需手动指定，避免被浏览器识别为xml格式。
2. 设置下载文件名：File方法的第三个参数即为浏览器下载时显示的文件名，直接传入带.odt后缀的Blob原始名称，即可触发正确格式的下载提示。

三、常见问题排查 #

• 若仍显示download.xml：
  • 检查Blob原始名称是否包含.odt后缀
  • 确认代码中File方法的第三个参数是否正确传入完整的blobName
  • 清除浏览器缓存或用无痕模式测试，排除缓存干扰
• 无需使用FileStream.OpenWrite：下载Blob无需写入本地文件，直接操作远程流即可，避免本地路径配置和IO开销

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