.NET 7 SignalR在IIS发布环境下25秒后断连重连问题排查

1. JWT认证配置差异排查 #

• 确认Program.cs中Release模式下AddJwtBearer的TokenValidationParameters配置完整，重点检查IssuerSigningKey、ValidateIssuer、ValidateAudience等参数是否在Release环境下正确加载（比如从配置文件读取而非仅Debug硬编码）。
• 核对中间件顺序：app.UseAuthentication()必须在app.UseRouting()之后、app.UseAuthorization()之前，且app.MapHub<YourHub>("/hubPath")需放在授权中间件之后。
• 临时在Hub的OnConnectedAsync方法中添加日志，打印JWT Token的Claims信息，验证Release环境下Token是否能正常解析。

2. IIS部署配置检查 #

• 确认应用程序池的托管管道模式为集成模式（SignalR不兼容经典模式），且.NET CLR版本选择与项目匹配的最新稳定版。
• 检查站点是否启用WebSocket协议：在IIS管理器站点的功能视图中找到WebSocket，确保已安装并启用（Release环境默认可能未开启）。
• 验证IIS站点的高级设置：调整最大请求长度、连接超时时间至合理值，避免因请求被截断导致连接失败。
• 确认Release发布包文件完整：检查bin/Release/netX.x/publish目录下是否包含Microsoft.AspNetCore.SignalR.Core等必要依赖文件，避免缺失依赖引发运行时错误。

3. 客户端与服务端兼容性验证 #

• 确保客户端@microsoft/signalr包版本与服务端Microsoft.AspNetCore.SignalR版本完全一致（大版本必须匹配，如服务端用.NET 6则客户端也用6.x系列）。
• 检查客户端连接地址：Release环境下需使用实际域名/IP，避免沿用Debug的localhost地址，且地址格式正确（如https://your-domain/hub，结尾不要加斜杠）。
• 分析客户端终端日志：
  • 若提示WebSocket failed: Error during WebSocket handshake，优先排查IIS WebSocket是否启用；
  • 若提示Unauthorized，聚焦JWT认证的Release配置问题；
  • 若提示Connection closed with error，检查服务端Hub是否在Release模式下吞了异常。

4. Release模式优化设置排查 #

• 关闭项目Release配置中的Trim unused code和Link assemblies选项：这些优化可能裁剪掉SignalR或JWT认证所需的依赖代码，导致运行时异常，关闭后重新发布测试。
• 确认Release环境下是否启用HTTPS强制跳转：若客户端用HTTP连接但服务端强制HTTPS，会引发重定向错误，需保证客户端连接协议与服务端一致。

5. 日志与调试辅助 #

• 服务端添加详细SignalR日志：

  builder.Logging.AddFilter("Microsoft.AspNetCore.SignalR", LogLevel.Debug);
  builder.Logging.AddFilter("Microsoft.AspNetCore.Http.Connections", LogLevel.Debug);
  

  发布后查看IIS日志文件（默认路径C:\inetpub\logs\LogFiles），定位SignalR相关错误。
• 客户端增强错误监听：

  connection.onclose((error) => {
      console.error('连接关闭:', error);
      setTimeout(() => startConnection(), 5000); // 自动重连尝试
  });
  connection.onError((error) => {
      console.error('SignalR错误:', error);
  });
  

  通过终端日志的具体错误信息缩小排查范围。

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