SignalR自定义RetryPolicy重连未生效，出现额外延迟问题

问题场景 #

在.NET 6环境下使用SignalR .NET客户端与服务端，自定义IRetryPolicy实现初始几次快速重连，但实际重连延迟比策略中指定的时间多约4秒，首次额外延迟甚至达到8秒，该现象可稳定复现。

自定义重连策略代码 #

connection = new HubConnectionBuilder()
  .WithUrl(url)
  .WithAutomaticReconnect(new RetryPolicy())
  .Build();

public class RetryPolicy : IRetryPolicy
{
  public TimeSpan? NextRetryDelay(RetryContext retryContext)
  {
    var delay = retryContext.PreviousRetryCount switch
    {
      < 5 => TimeSpan.FromSeconds(0),
      < 10 => TimeSpan.FromSeconds(5),
      _ => TimeSpan.FromSeconds(10),
    };
    Console.WriteLine($"NextRetryDelay count: {retryContext.PreviousRetryCount} elapsed: {retryContext.ElapsedTime} delay: {delay}");
    return delay;
  }
}

断开连接后的输出日志 #

NextRetryDelay count: 0 elapsed: 00:00:00 delay: 00:00:00
NextRetryDelay count: 1 elapsed: 00:00:08.1187903 delay: 00:00:00
NextRetryDelay count: 2 elapsed: 00:00:12.1619132 delay: 00:00:00
NextRetryDelay count: 3 elapsed: 00:00:16.2117377 delay: 00:00:00
NextRetryDelay count: 4 elapsed: 00:00:20.2883145 delay: 00:00:00
NextRetryDelay count: 5 elapsed: 00:00:24.3593463 delay: 00:00:05
NextRetryDelay count: 6 elapsed: 00:00:33.4387382 delay: 00:00:05
NextRetryDelay count: 7 elapsed: 00:00:42.4919265 delay: 00:00:05
NextRetryDelay count: 8 elapsed: 00:00:51.5778513 delay: 00:00:05
NextRetryDelay count: 9 elapsed: 00:01:00.6560698 delay: 00:00:05
NextRetryDelay count: 10 elapsed: 00:01:09.7329655 delay: 00:00:10
NextRetryDelay count: 11 elapsed: 00:01:23.7992479 delay: 00:00:10
NextRetryDelay count: 12 elapsed: 00:01:37.8539388 delay: 00:00:10

问题分析与解决方案 #

额外延迟的来源 #

这些额外延迟并非来自自定义重连策略，而是SignalR客户端内置的HTTP请求超时机制。当重连触发时，客户端会立即发起连接请求，但默认的HTTP请求超时时间为10秒（日志中显示的8秒左右是请求尝试失败的实际耗时），这个超时等待时间是独立于IRetryPolicy设置的延迟的。

简单来说：你的策略返回0秒延迟后，客户端立刻发起连接，但该请求需要等待超时失败后，才会进入下一次重连流程，日志中的ElapsedTime包含了每次连接请求的超时耗时，而非你设置的延迟时间。

解决方法 #

要让重连严格遵循自定义策略，需要缩短HTTP请求的超时时间，让连接失败的判定更快，从而快速进入下一次重连。可以通过WithUrl的配置项调整超时：

connection = new HubConnectionBuilder()
  .WithUrl(url, options =>
  {
    // 设置短超时，比如1秒，可根据实际网络情况调整
    options.HttpMessageHandlerFactory = _ => new HttpClientHandler
    {
      Timeout = TimeSpan.FromSeconds(1)
    };
    // 若使用WebSocket传输，可额外配置WebSocket超时
    options.WebSocketConfiguration = wsOptions =>
    {
      wsOptions.ConnectTimeout = TimeSpan.FromSeconds(1);
    };
  })
  .WithAutomaticReconnect(new RetryPolicy())
  .Build();

注意事项 #

• 超时时间不宜设置过短，避免正常网络波动导致不必要的连接失败
• 调整超时后，RetryContext.ElapsedTime会更接近你设置的延迟总和，能更准确反映重连流程的实际耗时

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