Worker Service 模板内置在 Visual Studio 2019+ 和 .NET CLI 中,可用 dotnet new worker -n MyBackgroundService 创建;应继承 BackgroundService 而非手动实现 IHostedService,正确使用 CancellationToken 实现可取消的后台任务,并注意部署时宿主适配与依赖注入规范。
Worker Service 项目模板在哪找
Visual Studio 2019 及以上或 .NET CLI 都自带 WorkerService 模板,不需要手动拼凑。用命令行最直接:
dotnet new worker -n MyBackgroundService
。注意不是 console 或 webapi 模板——后者虽然也能跑后台逻辑,但会引入不必要的 HTTP 栈和生命周期管理,增加启动开销和潜在干扰。
IHostedService 和 BackgroundService 的区别
两者都用于注册长期运行任务,但 BackgroundService 是 IHostedService 的抽象基类,已帮你处理了启动/停止信号的线程安全等待逻辑。直接继承 BackgroundService 更稳妥,避免手写 TaskCompletionSource 或死锁在 StopAsync 里。
常见错误:在 ExecuteAsync(CancellationToken) 中用 while(true) + Thread.Sleep ——这会阻塞线程且不响应取消信号。正确做法是:
- 用
await Task.Delay(1000, stoppingToken) - 每次循环开头检查
stoppingToken.IsCancellationRequested - 把耗时操作包进
try/catch,避免未捕获异常导致服务静默退出
如何注入依赖并访问配置
BackgroundService 实例由 DI 容器创建,所以构造函数可直接接收 IConfiguration、ILogger、自定义仓储等。但注意: