客户端启动后SignalR连接不存在的原因及解决方法

问题描述 #

部分客户端会间歇性触发服务端抛出以下异常：

Connection 'xxx' does not exist.
System.IO.IOException: Connection 'xxx' does not exist.
at Microsoft.AspNetCore.SignalR.DefaultHubLifetimeManager`1.InvokeConnectionAsync[T](String connectionId, String methodName, Object[] args, CancellationToken cancellationToken)

该异常甚至会在客户端调用hub.StartAsync几秒后出现，是服务端尝试调用客户端方法时触发的错误。目前已将服务端日志级别提升至Debug：

"Microsoft.AspNetCore.Http.Connections": "Debug",
"Microsoft.AspNetCore.SignalR": "Debug",

客户端连接构建代码如下：

hub = new HubConnectionBuilder()
.WithUrl(Constants.HubsUrl + "/MainHub", options =>
{
    options.Headers.Add(Constants.HeaderToken, token);
    options.UseDefaultCredentials = true;
})
.ConfigureLogging(logging =>
{
    logging.AddDebug();
    logging.SetMinimumLevel(Microsoft.Extensions.Logging.LogLevel.Warning);
})
.WithAutomaticReconnect(new[] { 
    TimeSpan.Zero, 
    TimeSpan.FromSeconds(5), 
    TimeSpan.FromSeconds(30)
})
.Build();

可能原因 #

• 客户端连接已断开但服务端仍持有旧ConnectionId：比如客户端遭遇网络波动、页面刷新/关闭未触发正常断开流程，或者自动重连后生成了新ConnectionId，但服务端还在使用旧ID尝试调用
• 分布式部署下连接状态不一致：服务端多节点部署时，默认的DefaultHubLifetimeManager仅维护当前节点的连接信息，其他节点调用该ConnectionId时会找不到
• 自动重连时序问题：客户端触发自动重连后，服务端尚未完成新连接的注册，此时发起客户端方法调用就会报错
• 连接生命周期管理疏漏：服务端未正确监听OnConnectedAsync/OnDisconnectedAsync事件，导致连接状态未及时更新

排查方法 #

• 分析Debug日志：重点查看SignalR和Http.Connections的Debug日志，定位异常发生时间点对应的ConnectionId创建、断开、重连记录，对比连接状态是否匹配
• 追踪ConnectionId生命周期：在服务端实现连接状态记录，记录每个ConnectionId的关联用户、创建时间、断开状态，异常发生时直接查询该ID的当前状态
• 补充客户端日志：将客户端日志级别调整为Debug，监控ConnectionState变化（Connected/Disconnected/Reconnecting），确认异常发生时客户端的连接状态
• 模拟场景复现：尝试模拟网络中断、浏览器页面休眠、快速刷新页面等场景，验证是否能复现异常

解决方案 #

• 调用前校验连接状态：在服务端调用InvokeConnectionAsync前，通过HubLifetimeManager.GetConnectionsAsync()检查目标ConnectionId是否存在，不存在则跳过调用
• 绑定用户与有效ConnectionId：避免直接缓存ConnectionId，而是维护用户标识到当前有效ConnectionId的映射，每次调用前获取最新ID（重连后ConnectionId会变更）
• 优化重连同步逻辑：客户端重连成功后，主动调用服务端Hub方法更新用户的ConnectionId映射；服务端通过OnConnectedAsync/OnDisconnectedAsync实时更新映射关系
• 分布式场景用共享存储：多节点部署时，使用Redis实现分布式HubLifetimeManager（引入Microsoft.AspNetCore.SignalR.StackExchangeRedis包），确保所有节点共享连接状态
• 捕获异常并处理：在服务端调用客户端方法的代码块中捕获IOException，记录日志后跳过无效调用，或触发用户在线状态校验

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