.NET中的后台任务(IHostedService)是什么?如何创建一个长时间运行的服务?

来源:这里教程网 时间:2026-02-21 17:30:30 作者:

.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<TimedBackgroundService>();
var app = builder.Build();
app.Run();

如果你使用的是传统的 ASP.NET Core 项目结构(Startup.cs),则在

ConfigureServices
方法中添加:

```csharp services.AddHostedService(); ```

常见应用场景与注意事项

这种模式适用于以下场景:

定期从数据库拉取待处理任务 监听消息队列(如 RabbitMQ、Kafka) 定时清理缓存或日志文件 保持与外部系统的长连接

注意点:

避免在
StartAsync
中阻塞线程,应使用异步或定时器机制。
始终处理取消令牌(CancellationToken),确保能优雅退出。 异常未捕获可能导致服务终止,建议在循环或回调中添加 try-catch。 若需更精确的调度,可结合
PeriodicTimer
或第三方库如 Hangfire。

基本上就这些。IHostedService 提供了一种标准方式来管理后台任务,集成简单且生命周期受控。

相关推荐