0

0

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

月夜之吻

月夜之吻

发布时间:2025-11-03 13:38:02

|

248人浏览过

|

来源于php中文网

原创

推荐使用 Worker Service 模板结合 IHostedService 与 Timer 实现后台定时任务。1. 创建 Worker Service 项目,生成基础结构;2. 在 Worker 类中重写 ExecuteAsync 方法,通过 Timer 每5分钟执行一次 DoWork 逻辑,并注册取消令牌确保优雅停止;3. 可在构造函数中注入 ILogger、IHttpClientFactory 等服务,实现日志记录或 HTTP 调用;4. 通过 dotnet publish 命令发布为自包含应用,支持部署为 Windows 服务或 Linux systemd 服务。该方式无需界面,适合长时间运行的周期性任务,关键在于避免阻塞主线程并正确处理 CancellationToken。

.net如何创建一个后台定时任务(worker service)

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

1. 创建 Worker Service 项目

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

dotnet new worker -n MyBackgroundTask

这会生成一个基础的 Worker 项目结构,包含 Program.csWorker.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 客户端或其他服务,可以在构造函数中注入它们。例如:

晓语台
晓语台

晓语台,是一款AI文本创作产品。创作能力主要围绕营销文本的AI创作,晓语台覆盖了品牌与市调、商业媒体、社交媒体、搜索营销、数字广告、职场办公共六类全营销文本

下载
private readonly IHttpClientFactory _httpClientFactory;

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

确保在 Program.cs 中注册了相关服务,如:

builder.Services.AddHttpClient();

4. 发布和部署

Worker Service 可以作为控制台应用运行,也可以发布为 Windows 服务或 Linux 后台服务(如 systemd)。

发布命令:

dotnet publish -c Release -r win-x64 --self-contained true

生成的可执行文件可以直接运行或注册为系统服务。

基本上就这些。通过 BackgroundService + Timer 的组合,你可以轻松实现一个稳定可靠的后台定时任务。关键是避免阻塞主线程,并正确处理取消令牌。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

226

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

429

2024.03.01

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

171

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

89

2025.11.27

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

452

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

6

2025.12.06

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

462

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

462

2023.08.10

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

10

2025.12.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Node.js 教程
Node.js 教程

共57课时 | 7.2万人学习

Java 教程
Java 教程

共578课时 | 37万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号