托管为Windows服务的.Net Core Worker Service偶发失效原因及修复

线程层的永久阻塞/循环意外跳出 #

• 最高发的触发场景是Worker核心循环链路中存在未做兜底的阻塞型调用：不少开发者为了快速适配逻辑，在异步循环链路里误用.Result、.Wait()这类同步阻塞方法，在Windows服务的Session 0隔离会话环境下，这类调用偶发会触发线程上下文死锁——Windows服务控制管理器（SCM）仅通过进程入口线程的状态判断服务是否运行，只要进程没有完全退出、入口线程没有发送停止指令，就会一直标记状态为“运行中”，但实际承载业务逻辑的后台循环线程已经永久卡在阻塞调用上，根本走不到下一次数据库查询的环节。
  • 修复方案：全链路排查Worker循环内的所有同步阻塞写法，将所有阻塞调用替换为原生await异步链路；在循环最外层加上结构化异常捕获，避免单条逻辑错误直接终止循环执行。
• 核心循环的CancellationToken判断逻辑写错：部分开发者实现Worker时，把循环退出判断while (!stoppingToken.IsCancellationRequested)写成了循环外的一次性判断，甚至在某次业务执行流程中意外触发了token的取消标记。由于Worker所在的Host进程本身没有收到系统下发的停止指令，整个进程不会退出，SCM依然会显示服务处于运行状态，但此时业务循环已经满足退出条件直接跳出，后续自然不会执行任何业务逻辑。
  • 修复方案：逐行核对Worker核心循环的逻辑，确保每轮循环执行前都会重新检查stoppingToken的状态，禁止在业务逻辑流程中随意修改token状态；在循环入口处加上带时间戳的运行日志，方便快速定位循环是否被意外跳出。

数据库链路的静默断连 #

• 由于Worker的核心逻辑是定时查询数据库，在没有配置瞬态错误重试策略的场景下，偶发的网络闪断、连接池耗尽、数据库连接失效都会抛出超时类异常。不少开发者为了避免服务因为单次异常崩溃，直接在循环最外层套了静默吞错的大try-catch块，捕获异常后没有做恢复逻辑就直接跳出整个循环——此时API和服务Host本身依然正常运行，SCM自然判定服务处于运行状态，但业务逻辑已经完全停摆。
  • 修复方案：在数据库访问层加上针对超时、连接失效类错误的自动重试降级策略；循环外层的异常捕获逻辑不能做静默吞错，捕获异常后必须经过固定等待时间重新回到循环起点，绝对不允许异常触发循环退出。

API集成时的服务注册错误 #

• 把Worker Service和.Net Core API集成时，很多开发者会因为DI生命周期配置错误导致Worker执行逻辑静默停止：比如错把Worker注册成Scoped生命周期服务（services.AddScoped<MyWorker>()）代替了托管服务的标准注册方式services.AddHostedService<MyWorker>()，虽然Host启动时会初始化一次Worker实例，但因为DI容器的生命周期不匹配，Worker的后台执行线程会在依赖资源释放后被GC回收，整个业务逻辑完全停摆——此时API本身依然可以正常响应请求，Windows服务的状态自然显示为运行中。
  • 还有一种偶发场景是注册了多个同类型的HostedService，其中某一个Worker因为资源锁、端口冲突启动失败，但Host没有将这类启动异常判定为致命错误，服务进程不会退出，SCM也会显示服务处于运行状态。
  • 修复方案：核对Worker的注册方式，必须通过AddHostedService将Worker注册为单例托管服务，绝对不能将长循环的业务逻辑写在短生命周期的服务实现中；给Worker的启动、每轮业务执行、停止流程都加上结构化日志，部署后通过日志持续输出状态和Windows服务状态做对照校验。

Windows托管环境的资源/权限异常 #

• 托管Windows服务的运行账号如果缺失数据库访问权限，或者进程长期运行出现句柄泄漏、内存占用触顶、线程数达到系统上限，就会出现业务线程卡在系统调用层无法返回的情况。这类场景下进程没有崩溃、服务控制线程没有发送停止指令，SCM的状态判断完全感知不到后台业务线程已经无法获得执行时间片，就会出现“显示运行但代码不执行”的假象。
  • 偶发场景还包括Session 0环境的桌面堆资源临时耗尽，导致进程内的新线程分配失败，承载业务逻辑的线程无法被系统调度执行。
  • 修复方案：为Windows服务的运行账号配置最小必要的数据库访问权限，定期监控服务进程的内存、句柄、线程数占用情况；给每轮业务操作加上独立的超时控制，单条操作执行超过阈值就强制取消当前流程，重新回到循环等待环节。

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