Blazor WebApp添加大量HTML触发同步操作禁止错误

问题原因 #

这是.NET 8 Preview版本中Blazor静态渲染机制的已知问题：当组件输出的HTML内容超过阈值（约20000字符）时，底层会触发同步IO操作，而ASP.NET Core默认禁止同步IO写入响应流，从而抛出该异常。

解决方案 #

方案1：临时启用AllowSynchronousIO（不推荐生产环境） #

在Program.cs中配置服务器允许同步IO：

var builder = WebApplication.CreateBuilder(args);

// 针对Kestrel服务器配置
builder.WebHost.ConfigureKestrel(options =>
{
    options.AllowSynchronousIO = true;
});

// 若使用HttpSys服务器，替换为以下配置
// builder.WebHost.ConfigureHttpSys(options =>
// {
//     options.AllowSynchronousIO = true;
// });

// 后续服务与中间件配置...
var app = builder.Build();

方案2：切换为交互式渲染模式 #

将Services.razor组件改为交互式渲染，绕过静态渲染的同步IO限制：
在组件顶部添加渲染模式指令：

@rendermode InteractiveServer

或在Program.cs的路由配置中全局指定：

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode()
    .AddAdditionalAssemblies(typeof(Services).Assembly);

方案3：升级.NET SDK版本 #

该问题已在.NET 8稳定版及后续预览版本中修复，升级到最新SDK即可彻底解决。

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