You need to enable JavaScript to run this app. 如何在Blazor Server中启用skipNegotiation设置以规避粘性会话依赖
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 03:54:04