.NET7 SignalR部署Win10 IIS后页面冻结、连接丢失问题求助

一、IIS配置检查 #

• 启用WebSocket协议：Win10 IIS默认未开启WebSocket，需手动开启——控制面板→程序→启用或关闭Windows功能→Internet信息服务→万维网服务→应用程序开发功能→勾选WebSocket协议，重启IIS生效。
• 应用程序池设置：.NET7应用需使用无托管代码的应用程序池，托管管道模式设为集成，避免因CLR版本不匹配导致连接异常。
• 站点绑定与防火墙：确认局域网访问的端口（如80/自定义端口）已在IIS站点绑定，且Win10防火墙允许该端口的入站规则，确保局域网内设备能正常访问站点。
• Hub路由验证：检查Program.cs中MapHub的路径（如app.MapHub<YourHub>("/your-hub")），客户端JS连接路径必须完全匹配。

二、客户端JS连接优化 #

• 修复JS文件引用：共享文件夹的SignalR JS在IIS部署后可能路径失效，建议将JS文件移至项目wwwroot目录，或配置IIS虚拟目录指向共享文件夹，确保页面能正确加载signalr.js/signalr.min.js。
• 添加重连与错误处理：在客户端连接代码中启用自动重连，并捕获错误日志，避免连接断开后无法恢复：

  const connection = new signalR.HubConnectionBuilder()
      .withUrl("/your-hub")
      .withAutomaticReconnect([0, 2000, 10000, 30000]) // 自定义重连间隔
      .build();
  
  connection.onclose(() => {
      console.warn("SignalR连接断开，将自动重连");
  });
  
  connection.start().catch(err => console.error("连接失败：", err));
  

• 避免页面冻结：检查页面B/C中处理推送数据的逻辑，若存在大量同步DOM操作（如循环插入节点），改为异步分批处理，防止阻塞主线程。

三、服务器端Hub调用规范 #

• 正确注入IHubContext：控制器中应注入IHubContext<YourHub>而非直接注入Hub实例，避免生命周期冲突：

  private readonly IHubContext<YourHub> _hubContext;
  
  public YourController(IHubContext<YourHub> hubContext)
  {
      _hubContext = hubContext;
  }
  
  public async Task<IActionResult> YourAction()
  {
      // 业务逻辑处理
      await _hubContext.Clients.Others.SendAsync("PushToTargetPage", data);
      return Ok();
  }
  

• 禁用不必要的会话依赖：因未使用Identity，SignalR连接基于独立的连接ID，若IIS启用了会话状态，可能导致连接锁定，建议在Program.cs中配置：

  builder.Services.AddSession(options =>
  {
      options.Cookie.IsEssential = false; // 非必要会话
  });
  

• 开启详细日志：添加SignalR日志便于定位异常：

  builder.Logging.AddConsole();
  builder.Services.AddSignalR(options =>
  {
      options.EnableDetailedErrors = true;
  });
  

  查看IIS日志（C:\inetpub\logs\LogFiles）或应用日志，排查连接失败、推送异常的具体原因。

四、Win10系统与网络排查 #

• 关闭网络节能模式：Win10的节能设置可能导致网络适配器休眠，影响SignalR长连接——设备管理器→网络适配器→右键属性→电源管理→取消勾选“允许计算机关闭此设备以节约电源”。
• 测试局域网连通性：用ping命令测试服务器与客户端的网络稳定性，用telnet 服务器IP 端口验证端口是否开放，排除网络波动或端口阻塞问题。

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