BackgroundService 是 C# 中一个抽象基类,位于 Microsoft.Extensions.Hosting 命名空间下,专为创建长时间运行的后台任务服务而设计。它适用于在 .NET Core 或 .NET 5+ 的托管环境中(如 Web 应用、Worker Service)运行循环执行的任务,比如定时处理消息、轮询数据库、发送心跳等。
BackgroundService 的核心作用
它封装了 IHostedService 接口的实现,让你只需关注任务逻辑,而不必手动管理服务的启动和停止生命周期。系统会在应用启动时自动调用 StartAsync,在关闭时优雅地触发 StopAsync,确保资源释放和任务安全退出。
如何轻松实现一个后台任务
下面是一个简单的示例,展示如何继承 BackgroundService 实现每10秒打印一次日志的后台任务:
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System.Threading;
using System.Threading.Tasks;
<p>public class MyBackgroundTask : BackgroundService
{
private readonly ILogger<MyBackgroundTask> _logger;</p><pre class='brush:php;toolbar:false;'>public MyBackgroundTask(ILogger<MyBackgroundTask> logger)
{
_logger = logger;
}
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
_logger.LogInformation("后台任务已启动");
while (!stoppingToken.IsCancellationRequested)
{
try
{
_logger.LogInformation("正在执行后台任务...");
// 模拟工作
await Task.Delay(10000, stoppingToken);
}
catch (OperationCanceledException)
{
// 停止信号触发,正常退出
break;
}
catch (Exception ex)
{
_logger.LogError(ex, "后台任务执行出错");
// 可选择等待后再继续
await Task.Delay(5000, CancellationToken.None);
}
}
_logger.LogInformation("后台任务已停止");
}}
在项目中注册后台服务
如果你使用的是 Worker Service 或 ASP.NET Core 项目,在 Program.cs 中添加服务注册:
var builder = Host.CreateApplicationBuilder(args); <p>// 添加后台服务 builder.Services.AddHostedService<MyBackgroundTask>();</p><p>var host = builder.Build(); await host.RunAsync();</p>
关键注意事项
ExecuteAsync 是核心方法:所有逻辑写在这里,必须响应 CancellationToken,避免应用无法正常关闭。 异常处理很重要:未捕获的异常可能导致任务终止,建议用 try-catch 包裹循环体。 避免阻塞调用:使用 async/await 和非阻塞方法,防止线程挂起。 支持依赖注入:构造函数可注入日志、配置、数据库上下文等服务。基本上就这些。用 BackgroundService 写后台任务不复杂,但容易忽略取消令牌和异常恢复,写的时候多注意这两点就够了。
