如何在Blazor Server中启用skipNegotiation设置以规避粘性会话依赖
Blazor Server 启用SkipNegotiation 解除粘性会话依赖的实操配置
实现无粘性会话部署的核心规则:所有链路强制仅使用WebSocket传输,客户端连接显式开启SkipNegotiation跳过协商流程,二者缺一不可。
服务端配置调整
首先在应用启动配置中,显式约束Blazor Hub的可用传输类型,关闭非WebSocket的传输通道:
// Program.cs 服务端配置代码 var app = builder.Build(); // ... 其他中间件配置 // 配置Blazor Hub的传输规则 app.MapBlazorHub(hubOptions => { // 仅保留WebSocket传输,禁用长轮询、SSE备选通道 hubOptions.Transports = HttpTransportType.WebSockets; }); app.Run();
同时需要打通部署环境的链路:反向代理、负载均衡、应用网关上的WebSocket透传规则要全部配置生效,不能存在中间环节截断长连接的情况。
客户端连接逻辑改造
Blazor Server默认的自动启动逻辑不会自带SkipNegotiation配置,需要关闭自动启动,手动构建SignalR连接参数:
- 首先引入Blazor脚本时关闭自动启动:
<!-- 替换默认的自动启动脚本引入方式 --> <script src="_framework/blazor.server.js" autostart="false"></script> - 手动初始化Blazor Circuit,给SignalR连接传入SkipNegotiation配置、单WebSocket传输约束:
<script> Blazor.start({ circuit: { configureSignalR: (hubConnectionBuilder) => { // 启用SkipNegotiation,跳过连接协商阶段 hubConnectionBuilder.withSkipNegotiation(true); // 指定连接地址,强制仅走WebSocket传输,和服务端配置对齐 hubConnectionBuilder.withUrl(`${window.location.origin}/_blazor`, { transport: signalR.HttpTransportType.WebSockets }); } } }); </script>
常见配置踩坑提醒
- 全链路的传输配置必须保持完全一致:服务端、客户端、中间负载均衡任一环节允许其他非WebSocket传输,都会导致SkipNegotiation失效,重新触发粘性会话依赖
- SkipNegotiation启用后,客户端会直接向指定的URL发起WebSocket长连接,不会通过协商接口获取后续连接的目标地址,整个流程没有跨节点的路由跳转,也就不需要粘性会话做连接落点绑定
- 子路径部署的站点需要仔细核对WebSocket连接的地址拼接规则,地址和实际Hub端点不匹配会直接导致连接握手失败
内容的提问来源于stack exchange,提问作者Daniil Sokolyuk
相关产品推荐
相关产品推荐

