Blazor生命周期方法中是否需捕获OperationCanceledException？

核心问题 #

在Blazor的生命周期方法（尤其是OnParametersSetAsync()）中，当通过CancellationTokenSource合法取消异步任务时，是否可以像事件处理程序那样不捕获OperationCanceledException？让该异常向上冒泡是否可行？框架能否像处理事件处理程序一样正确处理生命周期方法中的取消操作？

异常冒泡的可行性 #

答案是可以，Blazor框架能够正确处理生命周期方法中抛出的合法取消异常。

和官方文档示例中的事件处理程序（如LongRunningWork）一致，框架在调用生命周期方法时，会捕获并处理OperationCanceledException这类因任务取消产生的异常，不会导致应用崩溃。你看到的控制台输出的异常信息只是调试级别的日志，属于正常现象，不会影响应用运行。

注意：只允许因任务取消抛出的OperationCanceledException冒泡，其他业务异常仍需自行捕获处理，避免未处理异常导致应用故障。

取消后代码执行的风险 #

当组件被释放（用户导航离开）后，OnParametersSetAsync()中未完成的用户代码如果继续执行，确实不会再触发子组件的生命周期方法，但仍存在风险：

• 如果后续代码包含修改注入服务数据、更新组件状态的操作，可能会导致数据冲突或内存泄漏；
• 未取消的异步任务（比如HTTP请求）会继续占用资源，直到完成。

因此，必须确保任务被取消后，OnParametersSetAsync()中后续的敏感代码完全不执行。最可靠的方式是在关键节点调用cts.Token.ThrowIfCancellationRequested()，或者在await异步任务后立即检查取消状态。

规范的实现方式 #

推荐采用让取消异常自然冒泡的方式，同时确保Dispose()正确取消并释放CancellationTokenSource。这样既保证任务被及时取消，又不会吞掉异常，同时框架会正确处理取消异常：

// MyPage.razor
<Child SomePara=@SomePara></Child>

@code{
    private CancellationTokenSource cts = new();
    object SomePara = new();

    protected override async Task OnParametersSetAsync()
    {
        Debug.WriteLine($"OnParametersSetAsync Start");
        // 同步操作...

        // 异步操作：传入取消令牌
        await Task.Delay(5000, cts.Token);
        await UnknownExternalTaskIWantToCancelAsync(cts.Token);

        // 检查是否已取消，确保后续代码不执行
        cts.Token.ThrowIfCancellationRequested();

        Debug.WriteLine($"OnParametersSetAsync End");
        // 取消后不应执行的操作，比如更新状态、调用服务等
    }

    public void Dispose()
    {
        Debug.WriteLine($"Disposing");
        cts.Cancel();
        cts.Dispose();
    }

    async Task UnknownExternalTaskIWantToCancelAsync(CancellationToken token)
    {
        // 实际场景可以是HTTP调用等异步操作
        Debug.WriteLine($" . . . . . START.");
        await Task.Delay(10000, token);
        Debug.WriteLine($" . . . . . FINISHED.");
    }
}

如果一定要捕获异常，需明确只捕获OperationCanceledException，避免吞掉其他异常：

protected override async Task OnParametersSetAsync()
{
    Debug.WriteLine($"OnParametersSetAsync Start");
    try
    {
        await Task.Delay(5000, cts.Token);
        await UnknownExternalTaskIWantToCancelAsync(cts.Token);
        
        cts.Token.ThrowIfCancellationRequested();
        
        Debug.WriteLine($"OnParametersSetAsync End");
        // 取消后不应执行的操作
    }
    catch (OperationCanceledException)
    {
        // 仅处理取消异常，直接返回即可
        return;
    }
    // 其他异常仍会冒泡，由框架或上层处理
}

不规范方案的问题 #

你提到的用isCancelled布尔值标记取消的方案存在严重缺陷：

• 异步任务本身没有被真正取消，会继续占用资源直到完成；
• 存在竞态条件：比如Dispose()设置isCancelled = true时，代码可能已经走到判断逻辑之后，导致后续敏感代码依然执行；
• 无法处理外部异步任务的取消逻辑（比如HTTP请求无法被中断）。

因此，这种方案不建议使用，必须通过CancellationToken来实现真正的任务取消。

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