使用 Hangfire 在 .NET 9 中实现方式可靠定时任务的最佳实践实用指南-45看点

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“采用 Hangfire 在 .NET 9 中实现方法可靠定时任务的最佳实……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

一、Hangfire 简介

Hangfire 是一个成熟的 .NET 后台任务框架，兼容：

Fire-and-Forget：立即执行一次任务
Delayed：延迟执行
Recurring：周期性任务
Continuations：任务链
Dashboard 可视化：监控任务状态和失败

Hangfire 的核心优势：

无需额外服务：能够直接运行在 ASP.NET Core 中。
持久化兼容：SQL Server、Redis、MongoDB 等。
稳定可靠：任务执行失败可自动重试。
易于扩展：兼容 DI、日志、分布式任务等。

二、新建 .NET 9 项目并安装依赖

新建 .NET 9 Web API 项目：

dotnet new web -n HangfireNet9Demo
cd HangfireNet9Demo

安装 Hangfire 和内存存储（测试用）：

dotnet add package Hangfire
dotnet add package Hangfire.MemoryStorage

如果是生产环境建议采用 SQL Server：

dotnet add package Hangfire.SqlServer

三、设置 Hangfire

在 Program.cs 中进行设置。NET 9 兼容 最小 API 风格：

using Hangfire;
using Hangfire.MemoryStorage;
using Hangfire.Common;
var builder = WebApplication.CreateBuilder(args);
// 配置 Hangfire 服务
builder.Services.AddHangfire(config =>
{
    // 测试环境使用内存存储
    config.UseMemoryStorage();
    // 生产环境推荐：
    // config.UseSqlServerStorage(builder.Configuration.GetConnectionString("HangfireDb"));
});
builder.Services.AddHangfireServer();
var app = builder.Build();
// 启用 Hangfire Dashboard，默认路径 /hangfire
app.UseHangfireDashboard();
// 根路由测试
app.MapGet("/", () => "Hangfire with .NET 9 is running...");

四、新建定时任务

1. Fire-and-Forget（立即执行任务）

app.Lifetime.ApplicationStarted.Register(() =>
{
    BackgroundJob.Enqueue(() => Console.WriteLine("立即执行的任务"));
});

2. Delayed（延迟任务）

app.Lifetime.ApplicationStarted.Register(() =>
{
    BackgroundJob.Schedule(() => Console.WriteLine("延迟 1 分钟执行"), TimeSpan.FromMinutes(1));
});

3. Recurring（周期任务）

周期任务通常用来定时报告、邮件或数据清理：

app.Lifetime.ApplicationStarted.Register(() =>
{
    var recurringJobManager = app.Services.GetRequiredService();
    recurringJobManager.AddOrUpdate(
        "say-hello-job", 
        Job.FromExpression(() => Console.WriteLine("Hello Hangfire .NET 9!")), 
        "*/1 * * * *", // 每分钟执行
        new RecurringJobOptions { TimeZone = TimeZoneInfo.Local }
    );
});

注意：

Cron 表达式必须是字符串。
Job.FromExpression 让 Hangfire 能够序列化方法调用。
RecurringJobOptions 可设置时区、队列等。

五、任务监控与管理

Hangfire 自带 Dashboard，能够监控：

执行历史
失败任务
任务重试
队列状态

访问：

http://localhost:5000/hangfire

在生产环境中，能够设置 身份验证：

app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    Authorization = new[] { new MyAuthorizationFilter() }
});

六、生产环境注意事项

持久化存储：MemoryStorage 仅适合测试，生产请采用 SQL Server 或 Redis。
任务重试：Hangfire 默认重试 10 次，可借助 [AutomaticRetry(Attempts = 5)] 调整。
队列隔离：复杂任务可设置不同队列，防止长任务阻塞短任务。
分布式任务：多服务器部署可共享同一数据库，自动协调任务执行。
日志与监控：结合 ILogger 或第三方监控系统，记录任务执行详情。

七、完整 Program.cs 示例 (.NET 9)

using Hangfire;
using Hangfire.MemoryStorage;
using Hangfire.Common;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHangfire(config => config.UseMemoryStorage());
builder.Services.AddHangfireServer();
var app = builder.Build();
app.UseHangfireDashboard();
app.MapGet("/", () => "Hangfire with .NET 9 is running...");
// Fire-and-Forget
app.Lifetime.ApplicationStarted.Register(() =>
{
    BackgroundJob.Enqueue(() => Console.WriteLine("立即执行的任务"));
    BackgroundJob.Schedule(() => Console.WriteLine("延迟 1 分钟执行"), TimeSpan.FromMinutes(1));
    var recurringJobManager = app.Services.GetRequiredService();
    recurringJobManager.AddOrUpdate(
        "say-hello-job",
        Job.FromExpression(() => Console.WriteLine("Hello Hangfire .NET 9!")),
        "*/1 * * * *",
        new RecurringJobOptions { TimeZone = TimeZoneInfo.Local }
    );
});
app.Run();

总结

结合项目来看，Hangfire + .NET 9 提供了一个轻量、可视化、可靠的定时任务解决方案。
内存存储适合开发调试，生产环境应采用持久化存储。
Cron 表达式、Job 表达式、队列与重试机制是核心概念。
Dashboard 让你实时监控任务执行状态

到此这篇关于采用 Hangfire 在 .NET 9 中实现可靠定时任务的最佳实践的文章就介绍到这了,更多相关.net hangfire定时任务内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多兼容脚本之家！

您可能感兴趣的文章:

采用Hangfire+.NET 6实现定时任务管理(建议)
.net core 基于Hangfire+Mysql持久化实现定时任务设置方法
Ｃ＃中的Hangfire和Quartz.NET 任务调度的区别解析
.net任务调度框架Hangfire简介
Abp集成HangFire开源.NET任务调度框架
.net5 采用Hangfire的过程记录
Hangfire在ASP.NET CORE中的轻松实现方法

使用 Hangfire 在 .NET 9 中实现方式可靠定时任务的最佳实践实用指南

目录