实现IHostedService后抛出TaskCanceledException异常的问题求助

{"ClassName":"System.Threading.Tasks.TaskCanceledException","Message":"A task was canceled.","Data":null,"InnerException":null,"HelpURL":null,"StackTraceString":" at Core_API.Services.HourlyService.ExecuteAsync(CancellationToken cancellationToken)","RemoteStackTraceString":null,"RemoteStackIndex":0,"ExceptionMethod":null,"HResult":-2146233029,"Source":"System.Private.CoreLib","WatsonBuckets":null}

该异常为IHostedService的ExecuteAsync方法绑定的取消令牌被触发导致，以下为具体排查修复方案：

常见触发原因 #

• 应用生命周期事件触发令牌取消：ExecuteAsync默认传入的cancellationToken和应用停止事件绑定，服务启动超时、应用优雅停机、健康检查失败触发进程重启都会触发该令牌取消
• 自定义逻辑提前触发令牌取消：ExecuteAsync内部自定义的CancellationTokenSource超时或者主动调用Cancel方法，未捕获取消异常直接向外抛出
• 依赖异步操作抛取消异常：内部调用的HTTP请求、数据库查询等异步操作超时或被取消，未做异常处理直接抛出，被托管服务框架识别为任务取消
• 服务注册配置问题：使用AddHostedService注册服务时同时配置了自动重启策略，前一个服务实例被销毁时会触发取消令牌，未处理就会抛出异常

排查步骤 #

• 给ExecuteAsync最外层增加取消异常捕获逻辑，区分正常取消和异常取消，参考代码如下：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    try
    {
        // 原有业务逻辑
        while (!stoppingToken.IsCancellationRequested)
        {
            // 你的定时任务逻辑
            await Task.Delay(TimeSpan.FromHours(1), stoppingToken);
        }
    }
    catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
    {
        // 应用正常停止触发的取消，属于预期行为，仅打日志即可
        _logger.LogInformation("小时级定时服务正常停止");
    }
    catch (Exception ex)
    {
        // 非预期异常，记录详细日志排查
        _logger.LogError(ex, "小时级定时服务触发未预期异常");
    }
}

• 检查内部所有异步调用是否都传入了正确的取消令牌，有没有单独配置过短的超时时间
• 查看应用系统日志，确认异常触发时间点有没有应用重启、进程回收、健康检查失败的相关记录
• 如果是定时执行逻辑，确认循环等待逻辑未使用Thread.Sleep这类同步阻塞方法，必须用带取消令牌的异步等待方法

特殊场景说明 #

如果确认是应用停止时触发的正常取消，仅需增加捕获逻辑即可，属于.NET托管服务的正常行为。如果是运行过程中无预期触发取消，优先排查内部异步调用的超时配置，以及进程是否被外部策略（比如k8s的OOM Kill、负载均衡的健康检查失败踢下线）主动终止。

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