Hangfire 是 .NET 平台开源后台作业调度框架，支持异步执行耗时任务、自带 Web 管理界面；需安装核心包及存储后端（如 SQL Server），在 Program.cs 中注册服务并启用 Dashboard；支持 Fire-and-forget、Delayed、Recurring、Continuation 四种作业类型；使用时注意方法可见性、依赖注入方式、多实例并发控制、幂等性及生产环境 Dashboard 权限限制。
Hangfire 是一个用于 .NET 平台的开源后台作业调度框架，支持在 ASP.NET Core 或普通 .NET 应用中异步执行耗时任务（如发邮件、生成报表、清理缓存等），且自带 Web 管理界面，无需 Windows 服务或第三方调度器。
一、安装 Hangfire 及依赖
通过 NuGet 安装核心包和存储后端（推荐 SQL Server 或 Redis）：
- Hangfire.Core：核心功能
- Hangfire.AspNetCore：ASP.NET Core 集成支持
- Hangfire.SqlServer（或 Hangfire.Redis）：持久化作业数据
以 SQL Server 为例，在项目中运行：
Install-Package Hangfire.AspNetCoreInstall-Package Hangfire.SqlServer
二、配置 Hangfire（ASP.NET Core）
在 Program.cs 中注册服务并启用中间件：
- 添加 Hangfire 服务，指定连接字符串和存储方式
- 启用 Dashboard（可选，用于监控和手动触发）
- 启动后台服务器（自动处理队列中的作业）
示例代码：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHangfire(config =>
config.SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
.UseSimpleAssemblyNameTypeSerializer()
.UseRecommendedSerializerSettings()
.UseSqlServerStorage(builder.Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddHangfireServer();
var app = builder.Build();
app.UseHangfireDashboard(); // 默认路径 /hangfire
app.MapHangfireDashboard(); // .NET 6+ 推荐写法
三、定义和触发后台作业
Hangfire 支持四种常见作业类型，直接调用静态方法即可入队：
-
Fire-and-forget：立即执行一次
BackgroundJob.Enqueue(() => Console.WriteLine("Hello!")); -
Delayed：延迟执行
BackgroundJob.Schedule(() => SendEmail("user@ex.com"), TimeSpan.FromMinutes(5)); -
Recurring：定时重复（类似 Cron）
RecurringJob.AddOrUpdate("daily-report", () => GenerateReport(), "0 0 * * *"); // 每天零点 -
Continuation：前序作业完成后触发
var jobId = BackgroundJob.Enqueue(() => DoStep1());
BackgroundJob.ContinueJobWith(jobId, () => DoStep2());
四、注意事项与建议
实际使用中需注意以下几点：
- 被调度的方法必须是 public static 或定义在 public class 中且方法为 public；若需依赖注入，改用 IJobActivator 或直接注入服务到后台类中（推荐封装为服务类 + 构造注入）
- Docker 或多实例部署时，确保只有一个 Hangfire Server 在消费队列（避免重复执行），可通过数据库锁或 Redis 分布式锁控制
- 敏感操作（如支付回调）建议加幂等性校验和重试策略（Hangfire 内置
AutomaticRetry特性） - Dashboard 默认开放所有权限，生产环境务必加身份验证（可用
DashboardOptions.Authorization配置中间件拦截）
基本上就这些。Hangfire 上手快、集成轻、可观测性强，适合大多数 .NET 后台任务场景。
