You need to enable JavaScript to run this app. Blazor Server部署到托管服务器后WebSocket连接失败偶发重连问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

Blazor Server部署到托管服务器后WebSocket连接失败偶发重连问题咨询

现有配置问题排查

你的Startup配置确实存在几处会引发WebSocket连接异常的问题:

  • 服务重复注册:你先后两次调用services.AddHttpContextAccessor(),还额外注册了services.AddScoped<HttpContextAccessor>(),AddHttpContextAccessor本身已经以单例模式注册了IHttpContextAccessor,重复注册且作用域冲突会导致WebSocket连接时上下文获取异常
  • 缺少必要中间件:仅配置了UseAuthentication,未添加UseAuthorization中间件,认证信息无法正确传递到Blazor Hub,会导致已认证用户的WebSocket连接被拒绝
  • 中间件顺序错误:UseStaticFiles放在了UseRouting之后,不符合ASP.NET Core的中间件执行顺序规范,可能导致静态资源和Blazor框架脚本加载异常,间接影响WebSocket连接初始化
  • Cookie配置不完整:HTTPS环境下SameSiteMode.None必须搭配Secure = CookieSecurePolicy.Always才能被浏览器正常接收,否则连接携带的认证Cookie会被拦截,导致连接鉴权失败
报错的可能原因

1. 托管环境配置问题

  • 反向代理未开启WebSocket支持:主流托管服务的前置反向代理(Nginx、IIS、Cloudflare等)默认会限制WebSocket协议,需要手动开启支持、配置不低于100秒的连接超时时间,否则空闲的WebSocket连接会被主动断开
  • IIS部署未安装WebSocket模块:Windows Server环境需要在服务器角色中单独安装WebSocket协议模块,否则无法处理Blazor的WebSocket请求
  • 负载均衡未开启会话粘性:多实例部署时如果没有配置会话粘性,WebSocket连接会被随机分发到其他实例,直接触发连接断开重连

2. 客户端网络限制

  • 部分用户的网络环境(公司内网、校园网、运营商防火墙)会屏蔽WebSocket协议,Blazor会自动降级到长轮询传输,切换过程中会弹出重连提示
  • 弱网环境下丢包率过高,超出Blazor默认的心跳检测阈值,会被判定为连接断开

3. Blazor服务参数问题

  • 未调整Blazor默认的连接超时、断开保留周期等参数,短时间的网络波动就会触发重连提示
修复方案
  1. 修正Startup配置,调整后代码如下:
public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        services.Configure<CookiePolicyOptions>(options =>
        {
            options.CheckConsentNeeded = context => true;
            options.MinimumSameSitePolicy = SameSiteMode.None;
            // HTTPS环境下必须添加该配置
            options.Secure = CookieSecurePolicy.Always;
        });
        services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
            .AddCookie(options => options.ExpireTimeSpan = TimeSpan.FromDays(1));

        services.AddMudServices();
        services.AddRazorPages();
        // 调整Blazor服务端连接参数,适配不稳定网络
        services.AddServerSideBlazor(options =>
        {
            options.DisconnectedCircuitRetentionPeriod = TimeSpan.FromMinutes(3);
            options.JSInteropDefaultCallTimeout = TimeSpan.FromMinutes(1);
        });
        
        // 仅保留一行HttpContextAccessor注册
        services.AddHttpContextAccessor();
        services.AddHttpClient();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        // 调整StaticFiles到Routing之前
        app.UseStaticFiles();
        app.UseCookiePolicy();

        app.UseRouting();

        // 按顺序添加认证、授权中间件
        app.UseAuthentication();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapBlazorHub();
            endpoints.MapFallbackToPage("/_Host");
        });
    }
}
  1. 检查托管环境配置:
  • 确认反向代理已开启WebSocket支持,超时时间设置不低于100秒
  • IIS部署的话确认已安装WebSocket服务器角色
  • 多实例部署时开启负载均衡的会话粘性功能

内容的提问来源于stack exchange,提问作者Lorenzo Belfanti

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.17 08:27:03