ASP.NET Core 中实现后台任务,推荐使用 IHostedService 接口,它是官方支持的、生命周期与应用绑定的后台服务机制,比裸线程或 Timer 更安全、可控,且能随 Host 启动/停止自动管理。
基础实现:继承 IHostedService
你需要实现两个核心方法:
StartAsync(启动时调用)和
StopAsync(应用关闭前调用)。注意:它本身不提供循环或定时能力,需自行配合
Task.Run、
Timer或
BackgroundService基类。 定义一个服务类,实现
IHostedService在
StartAsync中开启长期运行逻辑(如轮询、监听、定时任务) 在
StopAsync中触发取消信号,等待任务优雅退出 务必使用
CancellationToken配合所有异步操作,避免强制终止引发资源泄漏
更推荐:继承 BackgroundService 抽象基类
BackgroundService是微软封装好的抽象类,内部已处理好启动/停止协调和异常捕获,你只需重写
ExecuteAsync(CancellationToken)方法即可,逻辑更清晰、健壮性更高。 该方法会被持续调用,适合做“常驻循环任务”,比如每 5 秒查一次数据库 使用
await Task.Delay(5000, stoppingToken)实现带取消感知的延时 若需定时执行(如每天凌晨2点),建议搭配
Quartz.NET或轻量级
Microsoft.Extensions.Hosting.Systemd+ 自定义调度逻辑,不要硬写复杂时间计算
注册与作用域注意点
后台服务默认以 Singleton 生命周期注册,但如果你的服务依赖了 Scoped 服务(如 DbContext),直接注入会出错——因为 Scoped 服务不能跨请求/跨线程安全使用。
解决办法:在ExecuteAsync内部手动创建 Scope,例如用
IServiceScopeFactory.CreateScope()每次循环或每次任务都新建 Scope,用完及时
Dispose(),避免 DbContext 被复用导致并发异常 别把 DbContext 直接注入到 BackgroundService 构造函数里
实际注册方式(Program.cs)
在 .NET 6+ 的最小托管模型中,注册非常简洁:
builder.Services.AddHostedService<MyBackgroundService>();
如果服务需要配置或依赖其他服务,也可以用工厂模式注册:
builder.Services.AddSingleton<IMyWorker, MyWorker>(); builder.Services.AddHostedService(sp => new MyBackgroundService(sp.GetRequiredService<IMyWorker>()));
基本上就这些。IHostedService 不复杂,但容易忽略取消令牌和作用域问题,这两点处理好了,后台任务就能稳稳跑在线上。
