Blazor Server持续出现HttpConnection.ProcessRequestsAsync Quic错误求助

问题分析 #

该错误源于Quic传输层处理错误码时的参数越界场景：错误码-1（通常代表未定义/未知错误）被传入了仅接受0x0到0x3fffffffffffffff范围的方法。尽管应用运行稳定，但持续的错误日志会占用系统资源，且大概率是潜在连接异常触发的底层逻辑问题。

排查与修复步骤 #

• 检查Quic自定义配置：确认项目中是否手动配置了QuicTransportOptions，若存在自定义错误码映射逻辑，排查是否意外传入了-1。可尝试重置为默认配置：

  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenAnyIP(5001, listenOptions =>
      {
          listenOptions.UseHttps();
          listenOptions.UseQuic();
          // 移除自定义QuicTransportOptions配置，恢复默认行为
      });
  });
  

• 升级.NET运行时版本：该问题大概率是.NET运行层Quic实现的已知bug，尤其常见于.NET 6/7的旧版本。升级至对应分支的最新补丁版本（如.NET 6.0.x最新版或.NET 8稳定版），官方通常已修复此类错误码边界处理问题。
• 过滤冗余错误日志：若暂时无法升级或修改配置，可在日志系统中过滤该错误以避免日志泛滥，示例配置（appsettings.json）：

  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.HttpConnection.ProcessRequestsAsync": "None"
    }
  }
  

• 监控客户端连接状态：虽然应用运行稳定，但可能存在客户端异常断开时触发Quic层错误码处理逻辑故障。可通过Blazor的NavigationManager连接事件，监控是否存在频繁断开重连的情况。

临时缓解方案 #

若上述步骤无法立即解决问题，可暂时切换回WebSocket传输（Blazor Server默认方式），规避Quic相关逻辑：

builder.Services.AddServerSideBlazor(options =>
{
    options.DetailedErrors = true;
    options.WebSockets.CloseTimeout = TimeSpan.FromSeconds(30);
    // 强制使用WebSocket，禁用Quic传输
    options.Transports = HttpTransportType.WebSockets;
});

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