C# Web应用中如何阻止SignalR空闲超时触发断开事件逻辑

方案1：基于内置异常特征判断（适用于SignalR Core 3.0+） #

SignalR触发OnDisconnectedAsync断开事件时，会通过入参传递触发断开的异常信息，空闲超时触发的断开会携带特定特征的异常，直接在方法入口判断即可跳过对应逻辑：

public override async Task OnDisconnectedAsync(Exception? exception)
{
    // 判定为空闲超时的条件，可根据本地实际运行的异常特征调整判断规则
    bool isIdleTimeout = exception is OperationCanceledException 
        && exception.Message.Contains("timeout", StringComparison.OrdinalIgnoreCase);

    if (!isIdleTimeout)
    {
        // 此处编写非空闲超时场景下需要执行的业务逻辑
    }

    await base.OnDisconnectedAsync(exception);
}

• 注意：不同SignalR版本的超时异常类型、消息文本可能存在差异，建议本地调试时先打印空闲超时场景下的exception内容，校准判断条件避免误判。

方案2：基于活跃时间标记判断（全版本兼容，准确率最高） #

该方案不依赖框架内置的异常特征，通过自行记录连接活跃时间、对比配置的超时阈值判定断开原因，不受版本迭代影响。

1. 首先配置SignalR全局超时参数，记录你设置的空闲超时阈值：

// Program.cs 或 Startup.cs 中注册SignalR服务时配置
services.AddSignalR(options =>
{
    // 客户端空闲超时时间，连接超过该时间未收到任何消息就会被判定超时断开
    options.ClientTimeoutInterval = TimeSpan.FromMinutes(5);
    // 服务端心跳发送间隔
    options.KeepAliveInterval = TimeSpan.FromSeconds(15);
});

2. 在Hub中记录每个连接的最后活跃时间，每次收到客户端消息就更新时间戳：

public override async Task OnConnectedAsync()
{
    // 连接建立时初始化活跃时间
    Context.Items["LastActiveTime"] = DateTimeOffset.UtcNow;
    await base.OnConnectedAsync();
}

// 每次收到客户端调用请求时更新活跃时间
public override async Task<T> InvokeMethodAsync<T>(string methodName, object?[] args)
{
    Context.Items["LastActiveTime"] = DateTimeOffset.UtcNow;
    return await base.InvokeMethodAsync<T>(methodName, args);
}

3. 在断开事件中对比活跃时间与超时阈值，判定为空闲超时时跳过业务逻辑：

public override async Task OnDisconnectedAsync(Exception? exception)
{
    // 和你之前配置的ClientTimeoutInterval值保持一致
    var idleTimeoutThreshold = TimeSpan.FromMinutes(5);
    var lastActive = Context.Items["LastActiveTime"] as DateTimeOffset?;

    bool isIdleTimeout = lastActive.HasValue 
        && DateTimeOffset.UtcNow - lastActive.Value >= idleTimeoutThreshold;

    if (!isIdleTimeout)
    {
        // 此处编写非空闲超时场景下需要执行的业务逻辑
    }

    await base.OnDisconnectedAsync(exception);
}

补充说明：如果你的业务存在主动踢用户下线、用户主动登出等主动断开场景，可以在主动调用Context.AbortAsync()前，给Context.Items写入自定义业务断开标记，和上面的超时判断逻辑结合使用，判定精度会更高。

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