Angular+C# SignalR部署IIS后持续发起Fetch请求问题排查

可能原因及对应解决方案 #

1. WebSocket协议未启用或配置错误 #

SignalR会优先使用WebSocket建立长连接，若IIS环境下WebSocket未开启，客户端会自动 fallback 到长轮询（Long Polling），这就会导致每隔固定时间发起Fetch请求。

• 开启IIS的WebSocket支持：
  1. 打开服务器管理器 → 添加角色和功能 → 找到Web服务器（IIS） → 应用程序开发 → 勾选「WebSocket协议」
  2. 重启IIS服务，运行命令：iisreset
• 后端确认WebSocket配置：
  在.NET Core项目的Startup/Program类中，确保已启用WebSocket并映射Hub：

  // .NET 6+ Program.cs示例
  app.UseWebSockets();
  app.MapHub<YourHub>("/your-hub-path");
  

2. 连接超时与心跳配置不匹配 #

本地IIS Express和生产IIS的默认超时参数可能存在差异，导致客户端频繁触发重连逻辑。

• 调整Angular客户端的SignalR连接参数：
  创建HubConnection时显式设置超时和心跳，避免依赖默认值：

  import { HubConnectionBuilder, LogLevel } from '@microsoft/signalr';
  
  const connection = new HubConnectionBuilder()
    .withUrl('/your-hub-path')
    .withAutomaticReconnect({
      nextRetryDelayInMilliseconds: () => 5000 // 自定义重连延迟，避免过于频繁
    })
    .configureLogging(LogLevel.Information)
    .build();
  
  // 与后端配置保持一致的超时参数
  connection.serverTimeoutInMilliseconds = 30000; // 30秒
  connection.keepAliveIntervalInMilliseconds = 10000; // 10秒
  

• 后端同步配置SignalR选项：

  builder.Services.AddSignalR(options =>
  {
      options.KeepAliveInterval = TimeSpan.FromSeconds(10);
      options.ClientTimeoutInterval = TimeSpan.FromSeconds(30);
  });
  

3. IIS缓存或代理干扰长连接 #

IIS的输出缓存、ARR（应用程序请求路由）代理可能提前断开SignalR长连接，引发客户端重复请求。

• 禁用Hub路径的输出缓存：
  在Web.config中添加针对Hub路径的缓存禁用配置：

  <location path="your-hub-path">
    <system.webServer>
      <caching enabled="false" />
      <staticContent>
        <clientCache cacheControlMode="DisableCache" />
      </staticContent>
    </system.webServer>
  </location>
  

• 若启用ARR代理，需开启WebSocket支持：
  打开IIS管理器 → 服务器节点 → 应用程序请求路由 → 服务器代理设置 → 勾选「启用WebSocket支持」

4. 防火墙或网络策略限制 #

Windows Server防火墙、企业网络策略可能阻断WebSocket握手，导致客户端只能使用长轮询。

• 检查服务器防火墙是否允许80（HTTP）/443（HTTPS）端口的WebSocket流量
• 若使用HTTPS，确认SSL证书配置有效，避免证书验证失败导致WebSocket连接中断

调试定位技巧 #

• 打开浏览器开发者工具（F12）→ Network标签，筛选「WS」类型，查看是否有成功建立的WebSocket连接：若无则说明协议协商失败， fallback 到了长轮询
• 客户端开启Debug日志：在HubConnectionBuilder中添加.configureLogging(LogLevel.Debug)，控制台会输出协商过程、传输协议选择的详细信息，快速定位问题

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