.NET如何创建一个后台定时任务(Worker Service)_后台定时任务创建步骤

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

在 .NET 中创建一个后台定时任务(Worker Service)非常简单,尤其适合用于执行周期性操作,比如数据清理、日志归档、调用外部 API 等。以下是使用 .NET 6+ 创建 Worker Service 的完整步骤。

1. 创建 Worker Service 项目

打开命令行工具或 Visual Studio,运行以下命令创建一个新的 Worker Service 项目:

dotnet new worker -n MyBackgroundService

这会创建一个名为 MyBackgroundService 的新项目,包含基础的后台服务模板。

2. 查看默认的 Worker 类

生成的项目中会包含一个 Worker.cs 文件,它继承自 BackgroundService,这是 .NET 提供的抽象类,用于实现长时间运行的后台任务。

关键方法是 ExecuteAsync,该方法会在应用启动后自动调用:

protected override async Task ExecuteAsync(CancellationToken stoppingToken) { while (!stoppingToken.IsCancellationRequested) { _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now); await Task.Delay(1000, stoppingToken); // 每秒执行一次 } }

你可以修改 Task.Delay 的时间间隔来控制任务执行频率。

3. 配置定时任务(如每分钟执行)

若要实现更精确的定时任务(例如每天凌晨执行),可使用 Timer 或计算下次执行时间。示例:每 5 分钟执行一次:

protected override async Task ExecuteAsync(CancellationToken stoppingToken) { while (!stoppingToken.IsCancellationRequested) { var nextRunTime = DateTime.Now.AddMinutes(5); _logger.LogInformation("任务执行时间: {time}", DateTime.Now);
    // 执行你的业务逻辑
    DoWork();
    var delay = nextRunTime - DateTime.Now;
    if (delay > TimeSpan.Zero)
        await Task.Delay(delay, stoppingToken);
}

}

也可使用 System.Timers.Timer 实现更简洁的定时触发。

4. 注册服务并运行

Program.cs 中,.NET 已自动注册了 Worker 服务:

var builder = Host.CreateApplicationBuilder(args); builder.Services.AddHostedService(); var host = builder.Build(); host.Run();

确保 AddHostedService 正确注册了你的 Worker 类。

启动项目后,后台任务将随应用程序一起运行。

5. 部署为 Windows 服务或 Linux 守护进程(可选)

若需将 Worker Service 部署为系统服务:

Windows:使用
sc create
命令或 Microsoft.Extensions.Hosting.WindowsServices 包。
Linux:配置 systemd 服务文件使其作为守护进程运行。

基本上就这些。通过 .NET 的 Worker Service 模板,你可以快速构建稳定可靠的后台定时任务。关键是合理使用取消令牌和异常处理,确保服务健壮性。

相关推荐