hangfire

项目地址： https://github.com/HangfireIO/Hangfire

官方文档： https://docs.hangfire.io/

NuGet： Hangfire.Core 1.8.25（核心）、Hangfire.AspNetCore 1.8.25（ASP.NET Core 宿主）

存储/配套： Hangfire.SqlServer 1.8.25、Hangfire.PostgreSql 1.21.1、Hangfire.InMemory 1.0.0、Hangfire.Dashboard.BasicAuthorization 1.0.2（截至 2026-10，NuGet）

目标框架： netstandard2.0 / netcoreapp3.0+ / .NET Framework 4.5.1+（Hangfire.Core 为 netstandard2.0）

许可证： LGPL-3.0

概述

Hangfire 把后台任务持久化到数据库（或内存/Redis），由独立的 worker 池拉取执行。任务在进程重启、部署滚动、机器宕机后仍会重试，这是它与 Task.Run / IHostedService 的本质区别。

• 三种任务形态：fire-and-forget（Enqueue）、延迟（Schedule）、周期（RecurringJob.AddOrUpdate + Cron）
• 持久化存储：SQL Server、PostgreSQL、MySQL、Redis、内存等，通过 UseXxxStorage 挂载
• 自动重试：默认失败后按指数退避重试 10 次，可用 [AutomaticRetry] 覆盖
• 仪表盘：/hangfire 可视化队列、重试、成功/失败任务与服务器心跳
• 任务链：ContinueJobWith 串联依赖任务
• 多实例安全：基于存储的分布式锁，多台服务器/多个容器共享同一存储时任务不会被重复执行

概念	说明
Job	一个待执行的方法调用（序列化后进存储）
Queue	任务队列，默认 default，可自定义并用 [Queue("name")] 指定
Server	执行任务的进程角色，AddHangfireServer() 或 UseHangfireServer() 启动
Storage	任务与状态持久化位置，必须显式配置

---

安装

方式一：dotnet CLI

# ASP.NET Core 宿主：核心 + 宿主集成
dotnet add package Hangfire.AspNetCore

# 存储实现（任选一个）
dotnet add package Hangfire.SqlServer
dotnet add package Hangfire.PostgreSql

# 本地开发 / 单元测试用内存存储
dotnet add package Hangfire.InMemory

方式二：PackageReference

<ItemGroup>
  <PackageReference Include="Hangfire.AspNetCore" Version="1.8.25" />
  <PackageReference Include="Hangfire.SqlServer" Version="1.8.25" />
  <PackageReference Include="Hangfire.Dashboard.BasicAuthorization" Version="1.0.2" />
</ItemGroup>

方式三：包管理器控制台

Install-Package Hangfire.AspNetCore -Version 1.8.25
Install-Package Hangfire.SqlServer -Version 1.8.25

验证安装

dotnet list package | grep -i hangfire

最小可运行验证（控制台，内存存储，无需数据库）：

using Hangfire;
using Hangfire.InMemory;

GlobalConfiguration.Configuration.UseInMemoryStorage();

using var server = new BackgroundJobServer();

BackgroundJob.Enqueue(() => Console.WriteLine("job ran: {0}", DateTime.Now));
Console.ReadLine();