.NET 10 Blazor WebAssembly静态HTML页面访问报500错误求助

问题背景 #

创建.NET 10长期支持版的独立Blazor WebAssembly应用，在wwwroot添加静态HTML页面后，调试时访问该页面触发500内部服务器错误，错误提示为「归档条目使用了不支持的压缩方法」，但未手动配置任何压缩功能，且wwwroot下的图片、JS文件可正常访问。

原因分析 #

调试模式下Visual Studio启用的**浏览器刷新中间件（BrowserRefreshMiddleware）**在处理HTML文件响应时，会自动尝试进行压缩操作，但存在兼容性bug，导致触发不支持的压缩方法错误。图片、JS文件未受影响是因为中间件对这类文件的压缩逻辑与HTML不同。

解决方案 #

方案1：禁用调试热重载（快速临时解决） #

直接关闭热重载功能，避免中间件介入HTML文件的处理：

• 在Visual Studio调试工具栏中，点击带闪电图标的热重载按钮，选择「禁用热重载」；
• 或者编辑项目Properties/launchSettings.json，找到对应调试配置，将"hotReloadEnabled": false。

方案2：调整静态文件处理配置（保留热重载） #

如果需要继续使用热重载，可通过配置静态文件中间件来规避压缩冲突：
编辑客户端项目的Program.cs，调整中间件顺序并明确HTML文件的内容类型配置：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// 配置静态文件的内容类型映射
builder.Services.AddStaticFiles(options =>
{
    var contentTypeProvider = new FileExtensionContentTypeProvider();
    contentTypeProvider.Mappings[".html"] = "text/html";
    options.ContentTypeProvider = contentTypeProvider;
});

builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseWebAssemblyDebugging();
}

// 优先启用静态文件中间件，再加载Blazor框架文件
app.UseStaticFiles();
app.UseBlazorFrameworkFiles();
app.MapRazorComponents<App>();

app.Run();

重启调试会话后，静态HTML页面即可正常访问。

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