IHostedService用于在.NET应用中运行后台任务,通过实现StartAsync和StopAsync方法管理服务生命周期。示例中创建TimedBackgroundService类,利用Timer每10秒执行一次任务,并在Program.cs中通过AddHostedService注册。适用于轮询、消息监听等场景,需注意异步处理、取消令牌和异常捕获,确保任务稳定运行。

.NET中的IHostedService是一个用于实现后台任务的接口,允许你在应用程序启动和关闭时运行长时间运行的逻辑。它非常适合处理轮询、消息监听、定时任务或任何需要在应用生命周期内持续运行的操作。
理解 IHostedService 接口
IHostedService定义了两个方法:
- StartAsync(CancellationToken cancellationToken):在应用主机启动后调用,用于开始后台操作。
- StopAsync(CancellationToken cancellationToken):在应用关闭时调用,用于优雅地停止后台任务。
你可以注册多个实现了该接口的服务,它们会随应用生命周期自动管理。
创建一个长时间运行的后台服务
下面是一个简单的示例,展示如何创建一个每10秒打印当前时间的后台服务。
1. 创建后台服务类
新建一个类,例如 TimedBackgroundService,并实现 IHostedService:
using Microsoft.Extensions.Hosting;
using System.Threading;
using System.Threading.Tasks;
public class TimedBackgroundService : IHostedService, IDisposable
{
private Timer? _timer;
public Task StartAsync(CancellationToken cancellationToken)
{
// 启动定时器,每10秒执行一次
_timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(10));
return Task.CompletedTask;
}
private void DoWork(object? state)
{
// 这里写你的后台逻辑
Console.WriteLine($"后台任务执行: {DateTime.Now}");
}
public Task StopAsync(CancellationToken cancellationToken)
{
// 停止定时器
_timer?.Change(Timeout.Infinite, 0);
return Task.CompletedTask;
}
public void Dispose()
{
_timer?.Dispose();
}
}2. 在 Program.cs 中注册服务
在 .NET 6+ 的最小API项目中,你需要将服务添加到依赖注入容器:
var builder = WebApplication.CreateBuilder(args); // 添加后台服务 builder.Services.AddHostedService(); var app = builder.Build(); app.Run();
如果你使用的是传统的 ASP.NET Core 项目结构(Startup.cs),则在 ConfigureServices 方法中添加:
常见应用场景与注意事项
这种模式适用于以下场景:
- 定期从数据库拉取待处理任务
- 监听消息队列(如 RabbitMQ、Kafka)
- 定时清理缓存或日志文件
- 保持与外部系统的长连接
注意点:
- 避免在
StartAsync中阻塞线程,应使用异步或定时器机制。 - 始终处理取消令牌(CancellationToken),确保能优雅退出。
- 异常未捕获可能导致服务终止,建议在循环或回调中添加 try-catch。
- 若需更精确的调度,可结合
PeriodicTimer或第三方库如 Hangfire。
基本上就这些。IHostedService 提供了一种标准方式来管理后台任务,集成简单且生命周期受控。









