SignalR Kestrel断开事件延迟触发问题求助（.NET Core 7）

问题核心 #

关闭Xamarin/WPF应用时OnDisconnectedAsync能快速触发，但禁用WiFi后要等数分钟才触发——客户端连接状态已显示断开，但服务器端的数据库、字典清理逻辑迟迟不执行。.NET Core 7中找不到相关文章提到的ServerTimeout配置项，当前SignalR配置如下：

hubOptions.EnableDetailedErrors = true;
hubOptions.ClientTimeoutInterval = TimeSpan.FromSeconds(30);
hubOptions.HandshakeTimeout = TimeSpan.FromSeconds(15);
hubOptions.KeepAliveInterval = TimeSpan.FromSeconds(15);

原因分析 #

1. ServerTimeout已被拆分替代：.NET Core 3.0+版本中，原ServerTimeout功能已拆分为ClientTimeoutInterval和KeepAliveInterval，这两个参数共同控制服务器对客户端断开的检测逻辑，不存在单独的ServerTimeout配置项。
2. TCP半开连接特性：禁用WiFi属于网络硬中断，TCP连接不会立即向服务器发送断开通知，服务器会持续发送KeepAlive包，直到超过系统默认的TCP重试次数和超时阈值（通常长达数分钟）才会判定连接失效，这会覆盖SignalR的配置逻辑。
3. SignalR清理周期延迟：即便SignalR通过心跳检测到客户端无响应，标记连接为断开状态，实际触发OnDisconnectedAsync还需等待连接池的清理周期，或底层传输层的最终断开信号。

解决办法 #

1. 优化SignalR心跳与超时配置 #

调整ClientTimeoutInterval和KeepAliveInterval的比例（客户端超时需为心跳间隔的2-3倍），缩短检测周期：

hubOptions.KeepAliveInterval = TimeSpan.FromSeconds(10);
hubOptions.ClientTimeoutInterval = TimeSpan.FromSeconds(30); // 至少为心跳间隔的2倍

更频繁的心跳能让服务器更快感知客户端无响应。

2. 配置Kestrel底层TCP超时 #

在Program.cs中修改Kestrel配置，覆盖系统默认的长TCP超时：

builder.WebHost.ConfigureKestrel(options =>
{
    options.Limits.IdleTimeout = TimeSpan.FromSeconds(40); // 略大于SignalR客户端超时时间
    options.Limits.KeepAliveTimeout = TimeSpan.FromSeconds(15);
});

让Kestrel更快关闭无响应的TCP连接，触发SignalR的断开事件。

3. 客户端主动触发断开（可选） #

如果客户端能提前检测到网络中断（比如WiFi关闭事件），主动调用connection.StopAsync()，让服务器立即触发OnDisconnectedAsync。

4. 补充主动检测逻辑 #

服务器端定时扫描活跃连接列表，结合数据库记录判断客户端是否离线，主动清理资源，避免完全依赖OnDisconnectedAsync的被动触发。

关键提醒 #

• .NET Core 3.0+确实已移除ServerTimeout，不要尝试寻找该废弃配置项，直接使用ClientTimeoutInterval和KeepAliveInterval组合实现超时检测。
• 网络硬中断场景下，TCP特性决定了服务器无法立即感知断开，只能通过心跳超时机制检测，合理配置心跳和超时是核心解决手段。

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