.NET如何创建一个后台定时任务（Worker Service）

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

在 .NET 中创建一个后台定时任务，最推荐的方式是使用 Worker Service 模板，并结合 IHostedService 与 Timer 实现周期性执行。这种方式适用于不需要用户界面的长时间运行服务，比如定时处理日志、调用 API、清理数据等。

1. 创建 Worker Service 项目

使用命令行或 Visual Studio 创建一个 Worker Service 项目：

dotnet new worker -n MyBackgroundTask

这会生成一个基础的 Worker 项目结构，包含

Program.cs

和

Worker.cs

。

2. 修改 Worker 类实现定时任务

默认的

Worker

类继承自

BackgroundService

，我们可以通过重写

ExecuteAsync

方法并使用

Timer

来实现定时逻辑。

示例代码：

using Microsoft.Extensions.Hosting;
using System;
using System.Threading;
using System.Threading.Tasks;

public class Worker : BackgroundService
{
    private readonly ILogger _logger;

    public Worker(ILogger logger)
    {
        _logger = logger;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        await Task.Run(() =>
        {
            var timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromMinutes(5)); // 每5分钟执行一次

            stoppingToken.Register(() => timer?.Change(Timeout.Infinite, 0));
        }, stoppingToken);
    }

    private void DoWork(object state)
    {
        _logger.LogInformation("定时任务正在执行：{time}", DateTime.Now);
        // 在这里添加你的业务逻辑
    }
}

说明：

TimeSpan.Zero
表示立即开始第一次执行。
TimeSpan.FromMinutes(5)
设置间隔时间为5分钟。
stoppingToken.Register
确保服务停止时，定时器也被正确释放。

3. 配置依赖注入和日志（可选）

如果需要在任务中使用数据库、HTTP 客户端或其他服务，可以在构造函数中注入它们。例如：

private readonly IHttpClientFactory _httpClientFactory;

public Worker(ILogger logger, IHttpClientFactory httpClientFactory)
{
_logger = logger;
_httpClientFactory = httpClientFactory;
}

确保在