我应该在什么时候调用CancellationToken.ThrowIfCancellationRequested？

核心前提说明 #

绝大多数第三方库的CancellationToken实现仅会终止内部执行逻辑，不会主动抛出OperationCanceledException，这是符合.NET设计规范的可选实现，不属于库的Bug。

是否需要每次调用完第三方函数后手动调用ThrowIfCancellationRequested()？ #

需要，除非你调用的第三方API官方文档明确标注其收到取消信号后会主动抛出取消异常。只要你无法100%确认库的行为，在第三方调用结束后追加取消检查是最稳妥的方案，能保证取消信号被及时响应。

自有代码中ThrowIfCancellationRequested()的调用时机 #

你不需要在每行代码后都加检查，只需要在以下几个关键节点插入即可：

• 循环迭代的边界：如果是while/for等长循环，在每一轮迭代的开始或结束位置加检查，控制取消响应的延迟上限，比如你能接受服务最多500ms后停止，那单轮循环的执行时长不要超过500ms即可。
• 高开销操作执行前：在执行大文件读写、跨网络请求、大内存分配、批量数据计算这类资源消耗高的操作之前先做检查，避免取消信号触发后还执行无意义的高成本操作。
• 独立逻辑块的边界：把你的业务逻辑拆成多个执行时长可控的小单元，每个单元执行完成后加一次检查即可，颗粒度可以根据你对停止速度的要求灵活调整。

补充注意点 #

• 如果你的逻辑中有需要手动清理的资源（比如打开的文件句柄、临时文件），可以先判断CancellationToken.IsCancellationRequested属性，执行完清理逻辑后再手动退出或者抛出异常，避免直接抛异常导致资源泄漏。
• 要确保你的Task外层逻辑能正确捕获OperationCanceledException，不要让未处理的取消异常导致整个服务进程崩溃。

示例代码参考：

// 队列循环处理场景示例
public async Task RunWorkerAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        // 调用不抛出取消异常的第三方库方法
        await _thirdPartySdk.FetchDataAsync(stoppingToken);
        
        // 第三方调用后检查取消
        stoppingToken.ThrowIfCancellationRequested();
        
        // 高开销操作前检查取消
        stoppingToken.ThrowIfCancellationRequested();
        await ProcessLargeBatchDataAsync();
    }
}

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