部署到AWS Fargate的Blazor Web App Counter页面无法稳定连接_blazor

问题现象 #

• 基础Blazor项目（含Home、Counter、Weather页面）访问Counter页面时，绝大多数场景下SignalR连接失败：
  • WebSocket连接_blazor端点失败，错误提示包含：端点非SignalR端点、服务器上不存在对应连接ID、代理阻止WebSocket、多服务器环境需启用粘性会话
  • ServerSentEvents因不支持Binary格式失败
  • LongPolling返回404错误，提示无匹配的连接ID
• 多次刷新页面后偶尔能成功建立SignalR连接，但离开页面时，_blazor/disconnect请求返回400（Bad Request）错误
• 当前排查方向聚焦于AWS环境或SignalR超时配置

排查步骤 #

1. 确认粘性会话配置
   若部署在AWS多服务器环境（如ECS、Elastic Beanstalk），必须确保负载均衡器已启用粘性会话。Blazor SignalR要求同一客户端的所有请求路由到同一服务器，否则会出现连接ID找不到的404错误。

2. 检查WebSocket支持

   • 验证AWS负载均衡器（ALB/NLB）已开启WebSocket协议支持，ALB默认支持，但需确认安全组、网络访问控制列表（NACL）允许WebSocket流量通过（端口与HTTP/HTTPS一致）
   • 检查服务器端配置，确保Program.cs中AddSignalR()未禁用WebSocket传输：

     builder.Services.AddSignalR();
     // 若手动指定传输方式，需包含WebSocket
     // builder.Services.AddSignalR().AddHubOptions<BlazorHub>(options =>
     // {
     //     options.Transports = HttpTransportType.WebSocket | HttpTransportType.LongPolling;
     // });
     

3. 调整超时相关配置

   • 调整SignalR的超时参数，在Program.cs中修改Hub配置：

     builder.Services.AddSignalR(options =>
     {
         // 缩短心跳间隔，避免负载均衡器主动断开连接
         options.KeepAliveInterval = TimeSpan.FromSeconds(15);
         // 延长客户端超时时间，匹配负载均衡器超时设置
         options.ClientTimeoutInterval = TimeSpan.FromSeconds(60);
     });
     

   • 检查AWS负载均衡器的空闲超时设置，ALB默认60秒，建议将其调整为大于SignalR KeepAlive间隔的2倍以上，防止负载均衡器提前断开空闲连接。

4. 处理ServerSentEvents的Binary兼容性问题
   若依赖ServerSentEvents作为降级传输方式，可禁用Binary格式，改用Text传输：

   builder.Services.AddSignalR()
       .AddHubOptions<BlazorHub>(options =>
       {
           options.MaximumReceiveMessageSize = 1024 * 1024;
       })
       // 禁用MessagePack（Binary协议），默认使用Text格式
       .RemoveProtocol(MessagePackProtocolDefaults.ProtocolName);
   

5. 排查断开请求400错误
   该错误通常是因为服务器端已提前释放连接，客户端发起断开请求时连接ID已失效。通过调整上述超时参数，确保客户端断开操作在连接有效期内触发，同时查看服务器日志确认是否存在连接被提前回收的情况。

6. 启用详细日志定位问题
   在appsettings.json中开启SignalR详细日志，获取连接建立、断开的完整流程记录：

   "Logging": {
       "LogLevel": {
           "Microsoft.AspNetCore.SignalR": "Debug",
           "Microsoft.AspNetCore.Http.Connections": "Debug"
       }
   }
   

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