.NET 8 Blazor事件回调内调用NavigationManager崩溃问题排查

问题场景 #

项目从.NET 6升级到.NET 8后，在Blazor组件的事件处理器内调用NavigationManager.NavigateTo抛出异常，具体场景如下：

事件定义 #

public event EventHandler OnKicked;

组件内事件注册（Home.Razor的OnParameterSet方法中） #

obj.OnKicked+= (x, y) =>
{
    navigationManager.NavigateTo("/youarekicked");
};

抛出的异常信息 #

Error: Microsoft.AspNetCore.Components.NavigationException: Exception of type 'Microsoft.AspNetCore.Components.NavigationException' was thrown.
at Microsoft.AspNetCore.Components.Server.Circuits.RemoteNavigationManager.NavigateToCore(String uri, NavigationOptions options)
at Microsoft.AspNetCore.Components.NavigationManager.NavigateToCore(String uri, Boolean forceLoad)
at Microsoft.AspNetCore.Components.NavigationManager.NavigateTo(String uri, Boolean forceLoad, Boolean replace)
at SpyGame.Components.Account.IdentityRedirectManager.RedirectTo(String uri) in

原因分析 #

.NET 8对Blazor Server的NavigationManager新增了严格的电路上下文校验逻辑：

• .NET 6中，即使NavigateTo在非活跃的Blazor电路上下文（比如组件已销毁、回调从非Blazor托管线程触发）中调用，框架仍会尝试执行导航，不会直接抛出异常。
• .NET 8中，框架会校验当前调用是否处于活跃的Blazor电路同步上下文内，若不满足条件（如组件销毁后事件仍被触发、回调执行线程不属于Blazor电路），则直接抛出NavigationException，以此避免无效导航操作和潜在的资源泄漏。

解决方法 #

1. 将导航操作封送到组件同步上下文
   使用组件的InvokeAsync方法，确保导航逻辑在Blazor的合法同步上下文中执行：

// 改为命名方法，方便后续取消订阅
private void OnKickedHandler(object sender, EventArgs e)
{
    _ = InvokeAsync(() => 
    {
        navigationManager.NavigateTo("/youarekicked");
    });
}

protected override void OnParametersSet()
{
    obj.OnKicked += OnKickedHandler;
    base.OnParametersSet();
}

2. 组件销毁时取消事件订阅
   避免组件销毁后事件回调被触发，导致无效的上下文调用：

protected override void Dispose(bool disposing)
{
    if (disposing)
    {
        obj.OnKicked -= OnKickedHandler;
    }
    base.Dispose(disposing);
}

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