Mac/iPad设备上Blazor Server端连接断开问题求助

架构老林

2026-8-19

Blazor Server在Safari（Mac/iPad）后台断连的解决办法

这本质是Safari在苹果生态的后台资源限制导致的——当浏览器切到后台后，Safari会主动限制甚至断开WebSocket连接，而Blazor Server依赖WebSocket维持实时通信；Windows浏览器没有这类严格的后台资源管控，所以不会出现该问题。下面是实测有效的解决思路：

1. 调整Blazor的重连与心跳配置

修改服务端Program.cs（.NET 6+）的Hub配置，延长超时时间并缩短心跳间隔，让连接更“坚挺”：

builder.Services.AddServerSideBlazor()
    .AddHubOptions(options =>
    {
        // 客户端超时时间设为5分钟
        options.ClientTimeoutInterval = TimeSpan.FromMinutes(5);
        // 每15秒发一次心跳包
        options.KeepAliveInterval = TimeSpan.FromSeconds(15);
    });

然后在前端_Host.cshtml里配置客户端重连参数，增加重连次数和间隔：

<script src="_framework/blazor.server.js" autostart="false"></script>
<script>
    Blazor.start({
        reconnectionOptions: {
            maxRetries: 10, // 最多重连10次
            retryIntervalMilliseconds: 3000 // 每3秒重试一次
        }
    });
</script>

2. 适配Safari后台行为

给用户加个提示：尽量保持Safari在前台，或者用iOS的画中画模式，别让浏览器完全后台化；
对非实时功能做离线兼容：断连时缓存用户操作，重连成功后再同步到服务器。

3. 检查反向代理的超时设置

如果应用用了Nginx、IIS这类反向代理，得让代理的超时时间和Blazor配置匹配，别中间先断了：
比如Nginx里要加这几项：

location /_blazor {
    proxy_pass http://你的Blazor服务器地址;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 300s;
    proxy_send_timeout 300s;
}