Blazor Server NavigationManager切页崩溃 如何取消当前页异步任务

Blazor 没有在页面导航时自动取消页面内未完成异步任务的内置机制，但你可以通过组件级CancellationTokenSource实现完全符合预期的取消逻辑，彻底解决快速导航导致的崩溃问题。

• 让需要执行异步操作的页面组件实现IDisposable接口
• 组件初始化时创建专属的CancellationTokenSource实例
• 页面内所有异步方法、HTTP请求、长耗时任务都传入该令牌源对应的Token
• 组件被释放（导航离开）时调用令牌源的Cancel()方法，触发所有关联异步任务的取消信号
• 所有异步操作的await节点后先判断令牌是否已触发取消，若已取消直接终止后续逻辑，不执行任何UI更新、状态修改操作
• 专门捕获OperationCanceledException，这类属于预期内的取消异常，无需额外处理

@page "/page3"
@implements IDisposable

<h3>Page3</h3>
<p>@DataContent</p>

@code {
    private CancellationTokenSource? _pageCts;
    private string? DataContent;

    protected override void OnInitialized()
    {
        // 每次进入页面新建令牌源，避免和其他页面/历史实例冲突
        _pageCts = new CancellationTokenSource();
    }

    protected override async Task OnInitializedAsync()
    {
        try
        {
            // 所有异步操作传入令牌
            await LongRunningLoad(_pageCts.Token);
            
            // 异步操作返回后先判断是否已经导航离开
            if (_pageCts.IsCancellationRequested)
            {
                return;
            }

            // 确认没取消再更新UI、修改状态
            DataContent = "数据加载完成";
        }
        catch (OperationCanceledException)
        {
            // 导航触发的取消属于正常行为，不做处理
        }
    }

    private async Task LongRunningLoad(CancellationToken ct)
    {
        // 示例1：HTTP请求直接传入令牌，请求会自动中断
        // var result = await Http.GetFromJsonAsync<DataDto>("api/load", ct);
        
        // 示例2：自定义长耗时任务传入令牌，可随时响应取消
        await Task.Delay(5000, ct);
    }

    public void Dispose()
    {
        // 导航离开组件释放时，触发所有关联任务的取消信号
        _pageCts?.Cancel();
        _pageCts?.Dispose();
    }
}

快速连续导航时，前序页面的组件实例会被框架立即释放，但组件内启动的异步任务仍在后台运行：

• 任务执行完成后会尝试调用StateHasChanged、修改组件字段、访问已被释放的依赖实例（如DbContext、组件级服务），直接触发对象已释放异常
• 若未捕获这类异常，会直接触发Blazor应用的全局未处理异常，导致电路断开（Blazor Server）或运行时崩溃（Blazor WebAssembly）

• 每个页面组件必须持有自己独立的CancellationTokenSource实例，禁止使用全局静态令牌，避免正常操作被误取消
• 不要在异步逻辑中无差别吞掉所有异常，仅捕获OperationCanceledException即可，其他业务异常需正常记录抛出
• 异步操作中每经过一次await，都建议加一次令牌状态判断，避免任务在await期间被取消后还执行后续无效逻辑
• 菜单点击不需要额外加防抖逻辑，只要所有页面正确实现上述取消机制，任意频率切换菜单都不会触发崩溃

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