如何避免Blazor Server中RemoteNavigationManager引发的TaskCanceledException

错误原因 #

• 客户端连接中断：用户在导航过程中关闭浏览器、刷新页面，或者网络临时断开，服务器无法和已断开的客户端通信，导致JSInterop异步调用任务被取消。
• 导航超时：Blazor Server的JSInterop调用有默认超时时间（默认1分钟），如果导航操作因客户端资源加载慢、JS执行延迟等超过这个时间，任务会被自动取消。
• 身份验证跳转冲突：未授权用户访问受限页面时，系统自动跳转Login页面，但原页面的电路（Circuit）可能已因身份验证流程被标记为待销毁，后续导航调用因电路失效被取消。

解决办法 #

• 捕获预期异常：在调用NavigateTo时包裹try-catch块，专门捕获TaskCanceledException，这类异常属于正常连接中断场景，无需抛出或记录错误：

try
{
    NavigationManager.NavigateTo("/Identity/Account/Login");
}
catch (TaskCanceledException)
{
    // 忽略导航取消的异常
}

• 调整超时配置：在Program.cs中延长Hub和JSInterop的超时时间，适配可能耗时的导航操作：

builder.Services.AddServerSideBlazor()
    .AddHubOptions(options =>
    {
        options.ClientTimeoutInterval = TimeSpan.FromMinutes(2);
        options.HandshakeTimeout = TimeSpan.FromMinutes(1);
    });

• 优化跳转逻辑：触发登录跳转时，使用forceLoad: true强制重载页面，避免电路冲突：

NavigationManager.NavigateTo("/Identity/Account/Login", forceLoad: true);

• 过滤冗余日志：在appsettings.json中配置日志过滤，屏蔽该类错误日志：

{
  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Components.Server.Circuits.RemoteNavigationManager": "Warning"
    }
  }
}

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