ASP.NET Core SignalR 在 Blazor WebAssembly 中的自动重连异常处理

在 ASP.NET Core 项目中，SignalR 是一个强大的实时通信库，而 Blazor WebAssembly 则是构建客户端 Web 应用的优秀框架。当两者结合使用时，开发者可能会遇到一些意想不到的问题，特别是在网络不稳定的情况下。

问题现象

在 Blazor WebAssembly 应用中使用 SignalR 客户端时，如果配置了自动重连策略，在网络多次断开又恢复的情况下，可能会出现未捕获的异常。这些异常会导致客户端无法继续正常工作，必须重新启动应用才能恢复连接。

典型的错误日志会显示类似以下内容：

System.InvalidOperationException: 无法完成操作
   在 Microsoft.AspNetCore.SignalR.Client.HubConnection.InvokeCoreAsync
   在 MyApplication.HubService.UpdateTokenAsync

问题根源

经过深入分析，发现问题并非出在 SignalR 的重连机制本身，而是开发者在调用 HubConnection 方法时没有正确处理可能抛出的异常。具体表现为：

1. 开发者虽然对 StartAsync() 方法进行了 try-catch 包装
2. 但在实际调用 Hub 方法（如 InvokeAsync）时没有进行异常处理
3. 当网络不稳定时，这些未处理的异常会中断整个连接流程

解决方案

正确的做法是对所有 SignalR 客户端操作都进行异常处理。特别是在调用 InvokeAsync 方法时，应该添加 try-catch 块：

if (this.connection.State == HubConnectionState.Connected)
{
    try
    {
        await this.connection.InvokeAsync("UpdateAccessToken", token)
            .ConfigureAwait(false);
    }
    catch (Exception ex)
    {
        // 记录日志或进行其他处理
    }
}

最佳实践

1. 全面异常处理：对所有 SignalR 客户端操作都进行异常捕获
2. 状态检查：在调用方法前检查连接状态
3. 重试策略：对于关键操作，可以实现自定义的重试逻辑
4. 日志记录：记录所有异常以便于问题诊断
5. 用户体验：在 UI 层面对用户进行适当的连接状态提示

总结

SignalR 在 Blazor WebAssembly 中的自动重连机制本身是可靠的，但需要开发者配合做好异常处理。通过全面捕获操作异常，可以确保应用在网络波动时保持稳定。这个问题提醒我们，在实时通信场景下，完善的错误处理机制与核心功能同等重要。

对于使用 SignalR 的开发者来说，理解并正确处理各种网络异常情况，是构建健壮实时应用的关键所在。