Blazor Server 6.0应用无法下载.msg文件问题求助

1. 显式配置静态文件的下载行为 #

在Program.cs里修改UseStaticFiles的配置，为.msg文件强制添加下载响应头，避免浏览器调用Outlook打开：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        if (ctx.File.Name.EndsWith(".msg", StringComparison.OrdinalIgnoreCase))
        {
            // 强制触发下载而非打开关联程序
            ctx.Context.Response.Headers.Append("Content-Disposition", $"attachment; filename={ctx.File.Name}");
            // 指定通用二进制流类型，绕过浏览器的类型识别
            ctx.Context.Response.ContentType = "application/octet-stream";
        }
    }
});

这个配置会覆盖IIS的MIME设置，直接为.msg文件注入下载指令。

2. 检查Blazor页面的链接写法 #

确保下载链接正确设置download属性，且路径指向wwwroot下的静态文件：

<a href="/files/your-file.msg" download="your-file.msg">下载.msg文件</a>

注意：如果文件放在wwwroot的子目录（比如wwwroot/files），href路径要以/开头，对应站点根目录。

3. 确认静态文件中间件的执行顺序 #

保证UseStaticFiles在路由和端点配置之前调用，避免Blazor路由拦截静态文件请求：

app.UseStaticFiles(); // 优先处理静态文件
app.UseRouting();
app.UseEndpoints(endpoints =>
{
    endpoints.MapBlazorHub();
    endpoints.MapFallbackToPage("/_Host");
});

4. 清除浏览器缓存 #

浏览器可能缓存了旧的MIME类型和响应头，导致新配置不生效。可以清除浏览器缓存后测试，或者给链接加版本参数（比如/files/your-file.msg?v=1）强制刷新资源。

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