c#如何使用Hangfire后台任务_c#Hangfire后台任务看这一篇就够了-C#.Net教程-PHP中文网

Hangfire任务不执行的最常见原因是未正确配置持久化存储或未调用app.UseHangfireServer()；必须显式注册SQL Server存储、启用HangfireServer，并区分BackgroundJob与RecurringJob的使用场景。

c#如何使用hangfire后台任务_c#hangfire后台任务看这一篇就够了

Hangfire 不是“开箱即用”的后台任务解决方案，它需要明确配置存储、正确注册服务、区分 BackgroundJob 与 IHostedService 的职责——否则任务不触发、状态丢失、甚至应用启动失败。

最常见原因是未正确配置持久化存储，或未调用 app.UseHangfireServer()。Hangfire 默认不自动启动后台工作进程，它依赖 HangfireServer 实例轮询数据库获取待执行任务。

必须在 Program.cs 中调用 services.AddHangfire(config => config.SetDataCompatibilityLevel(CompatibilityLevel.Version_170).UseSimpleAssemblyNameTypeSerializer().UseRecommendedSerializerSettings().UseSqlServerStorage("your-connection-string", new SqlServerStorageOptions { CommandBatchMaxTimeout = TimeSpan.FromMinutes(5), SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5), QueuePollInterval = TimeSpan.FromSeconds(15), UseRecommendedIsolationLevel = true, DisableGlobalLocks = true }));
必须在 app.UseHangfireServer()（.NET 6+ 中放在 app.Build() 之后、app.Run() 之前）
若使用 IHostedService 手动启停 HangfireServer，请确认未与 UseHangfireServer() 冲突——二者选其一，重复会导致 ObjectDisposedException
检查数据库表是否已创建：HangFire schema 下应有 Job、JobQueue、State 等表；首次运行时若没权限建表，会静默失败（日志里搜 Failed to create schema）

不同调度方式对应不同 API，混用会导致行为不符合预期：比如用 BackgroundJob.Schedule 调用一个本该由 RecurringJob.AddOrUpdate 管理的定时逻辑，结果只执行一次就消失。

一次性立即执行：BackgroundJob.Enqueue(() => Console.WriteLine("now"));
延迟执行（30秒后）：BackgroundJob.Schedule(() => Console.WriteLine("later"), TimeSpan.FromSeconds(30));
周期性执行（每5分钟）：RecurringJob.AddOrUpdate("my-cron-job", () => Console.WriteLine("cron"), "0 */5 * * *");（注意 cron 表达式格式为 Seconds Minutes Hours Day Month DayOfWeek，Hangfire 默认不支持秒级字段，需启用 UseRecommendedSerializerSettings() 并确认版本 ≥ 1.7.28）
避免在控制器中直接传参复杂对象：序列化失败会卡在 Enqueued 状态；优先传 ID，再在任务方法内查库

Hangfire 默认使用自己的 IServiceProvider 实例，不共享 ASP.NET Core 的 DI 容器——除非显式配置。这意味着你在 Startup.cs 或 Program.cs 中注册的 IMyService，在任务方法里直接构造函数注入会失败。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

解决方法一（推荐）：在 AddHangfire 配置中传入当前 IServiceProvider：.UseServiceProviderFactory(new DefaultServiceProviderFactory())（仅限 .NET 5+），或更稳妥地用 services.AddHangfire(config => { ... config.UseActivator(new AspNetCoreJobActivator(app.Services)); });
解决方法二：改用 JobActivator 自定义激活逻辑，从 app.Services 解析服务
切勿在任务方法签名中依赖 IHttpContextAccessor——后台任务无 HTTP 上下文，必抛异常

Hangfire Dashboard 是唯一可靠的任务可视化入口，但它默认不暴露敏感操作（如删除、重试），且生产环境必须加认证。

启用 Dashboard：app.UseHangfireDashboard("/hangfire", new DashboardOptions { Authorization = new[] { new LocalRequestsOnlyAuthorizationFilter() } });
失败任务会进入 Failed 列表，点击可看到完整异常堆栈（含 InnerException）；重试前先确认是否是幂等性问题（如重复扣款）
日志默认输出到 Console 和 Debug，如需写入文件，请配置 NLog 或 Serilog 并在 AddHangfire 时传入 SetLoggerFactory
注意：Dashboard 中的 Retry 按钮不会重置重试次数计数器，而是按原策略再试一次；若已超 RetryAttempts（默认 10），需手动 Delete 后 Requeue