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 后台任务场景。
