Blazor Server长时间闲置后刷新异常及.NET 6重连方案咨询

一、.NET 6 下实现自动自定义重连逻辑 #

.NET 6 没有官方开放可修改的boot.js，但可以通过覆盖Blazor的SignalR连接配置来实现自动重连，替代仅隐藏提示的方案：

1. 创建自定义重连脚本
   在项目wwwroot目录下新建custom-blazor-reconnect.js，写入以下代码：

Blazor.start({
  // 配置SignalR连接
  configureSignalR: (builder) => {
    const hubConn = builder.build();
    
    // 监听连接断开事件，自动循环重试
    hubConn.onclose(async (err) => {
      const retryGap = 3000; // 每次重试间隔3秒
      while (true) {
        try {
          await hubConn.start();
          console.log("重连成功");
          break;
        } catch (retryErr) {
          console.log(`重连失败，${retryGap}ms后重试`, retryErr);
          await new Promise(resolve => setTimeout(resolve, retryGap));
        }
      }
    });
    return hubConn;
  },
  // 禁用默认的重连提示弹窗
  suppressErrorUI: true
});

2. 替换默认脚本引用
   在_Host.cshtml中，将自定义脚本放在Blazor官方脚本之前引入：

<script src="~/custom-blazor-reconnect.js"></script>
<script src="_framework/blazor.server.js"></script>

这样配置后，连接断开时会自动重试，无需手动点击控件恢复。

二、解决Chrome闲置3分钟断开的问题 #

Chrome后台标签的节能机制会限制JS执行，导致SignalR连接超时。除了关闭节能模式，还可以通过以下两种方式优化：

• 调整SignalR心跳参数
  在Program.cs中修改Hub配置，缩短心跳间隔和客户端超时，避免浏览器判定连接闲置：

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

• 页面激活时主动重连
  在自定义脚本中添加页面可见性监听，当页面从后台切回前台时，主动检查并恢复连接：

document.addEventListener('visibilitychange', async () => {
  if (document.visibilityState === 'visible' && !Blazor.connection?.state) {
    try {
      await Blazor.connection.start();
      console.log("页面激活后重连成功");
    } catch (err) {
      console.log("页面激活后重连失败", err);
    }
  }
});

三、.NET 7 迁移的风险与建议 #

从.NET 6迁移到.NET 7的风险极低，属于.NET生态的小版本迭代，官方保证向下兼容：

• 提前检查依赖：确认项目中使用的第三方NuGet包是否支持.NET 7，主流包基本都已适配。
• 测试环境验证：先在测试环境完成迁移，运行现有自动化测试，重点验证Blazor组件渲染、SignalR连接逻辑、自定义业务代码等核心模块。
• 升级后的收益：.NET 7开放了boot.js的定制权限，可以直接修改重连逻辑，官方提供了更灵活的reconnectHandlerAPI，能精细控制重连次数、间隔和自定义提示UI，后续维护成本更低。

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