Razor应用中OperationCancelled Exception未被捕获问题排查

我有一个Razor应用，多数客户端页面在OnInitializeAsync中使用Http.GetFromJsonAsync发起请求。快速切换页面时会抛出OperationCancelled Exception。我已在请求外添加try-catch捕获，还尝试为请求传入CancellationTokenSource Token，并在页面的DisposeAsync中调用Cancel()来规避异常，但仍会抛出该异常。我怀疑原因是页面已导航离开并销毁后，客户端才收到服务器响应。

客户端页面代码如下：

private List<ClassX> list;
private CancellationTokenSource tokenSource = new();
protected override async Task OnInitializedAsync(){
    try{
        list = await Http.GetFromJsonAsync<List<ClassX>>("ServerURL", tokenSource.Token) ?? new();
        tokenSource.Token.ThrowIfCancellationRequested();
    }
    catch (Exception e) when (e is OperationCanceledException || e is ObjectDisposedException)
    {
        Console.WriteLine($"{e}");
        return;
    }
}

public async ValueTask DisposeAsync()
{
    tokenSource.Cancel();
    tokenSource.Dispose()
}

我原本期望通过在Dispose中调用Cancel，让异常能被OnInitializeAsync中的try-catch捕获。根据微软文档，这是取消任务和释放token source的正确方式。

我想知道：

• CancellationTokenSource是否是告知客户端页面请求已无效的正确方式？
• 我的实现是否正确？若正确，为何仍会抛出未被捕获的OperationCancelled Exception？
• 我曾尝试在using语句中使用CancellationTokenSource，但认为这样无法在页面销毁时取消请求。
• 可能我对CancellationTokenSource或Razor组件生命周期理解有误，希望找到方法让异常被捕获，避免用户看到浏览器底部的“未处理异常”弹窗。

问题分析与解决方案 #

1. CancellationTokenSource是正确方案，但实现存在疏漏 #

CancellationTokenSource确实是取消异步请求、标记请求无效的标准方式，但你的代码有几个关键问题：

• DisposeAsync语法错误：tokenSource.Dispose()末尾缺少分号，会导致编译失败，取消操作根本没被执行。
• 取消时机与生命周期冲突：快速导航时，组件DisposeAsync触发时，OnInitializeAsync中的请求可能已完成，或取消信号抛出异常的时机超出了try-catch的覆盖范围。
• 冗余的ThrowIfCancellationRequested：Http.GetFromJsonAsync本身会在令牌取消时抛出OperationCanceledException，额外调用该方法只会在请求完成后触发不必要的异常。

2. 未捕获异常的核心原因 #

组件销毁后，OnInitializeAsync的异步任务可能仍在后台运行，此时取消令牌触发的异常会因为组件上下文已释放，无法被组件内的try-catch捕获，最终冒泡到全局异常机制。

3. 修正后的实现方案 #

方案一：修复手动CancellationTokenSource逻辑

private List<ClassX> list;
private CancellationTokenSource _cts;

protected override async Task OnInitializedAsync()
{
    _cts = new CancellationTokenSource();
    try
    {
        list = await Http.GetFromJsonAsync<List<ClassX>>("ServerURL", _cts.Token) ?? new List<ClassX>();
    }
    catch (OperationCanceledException)
    {
        Console.WriteLine("请求已取消");
        return;
    }
    catch (ObjectDisposedException)
    {
        Console.WriteLine("令牌源已释放");
        return;
    }
}

public async ValueTask DisposeAsync()
{
    _cts?.Cancel();
    _cts?.Dispose();
    GC.SuppressFinalize(this);
}

• 补全语法错误，添加空值检查避免空引用异常
• 移除冗余的ThrowIfCancellationRequested，让请求方法自行处理取消逻辑

方案二：使用Blazor内置组件生命周期令牌（推荐）

Blazor组件自带CancellationToken属性，会在组件销毁时自动触发取消，无需手动管理CancellationTokenSource：

private List<ClassX> list;

protected override async Task OnInitializedAsync()
{
    try
    {
        list = await Http.GetFromJsonAsync<List<ClassX>>("ServerURL", CancellationToken) ?? new List<ClassX>();
    }
    catch (OperationCanceledException)
    {
        Console.WriteLine("组件销毁，请求已取消");
        return;
    }
}

这种方式完全贴合Blazor组件生命周期，无需手动处理令牌源的创建与释放，代码更简洁可靠。

4. 全局异常兜底配置 #

为避免遗漏异常弹出给用户，建议配置全局异常处理：
在Program.cs中添加：

builder.Services.AddBlazorWebAssemblyLogging();

在根组件App.razor中使用ErrorBoundary包裹路由：

<ErrorBoundary>
    <Router AppAssembly="@typeof(App).Assembly">
        <!-- 路由内容 -->
    </Router>
</ErrorBoundary>

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