Hangfire中WithJobExpirationTimeout配置未按预期生效问题

问题描述 #

在Program.cs的Hangfire配置中添加.WithJobExpirationTimeout(TimeSpan.FromDays(60))后，仪表盘显示作业过期超时时间仍为3小时，未达到预期的60天。

原因分析 #

你使用的Hangfire.InMemory 1.0.0存储不支持全局作业过期超时配置。WithJobExpirationTimeout方法仅对SQL Server、Redis等持久化存储生效，InMemory存储有固定的默认3小时过期时间，且不支持全局修改。

解决方案 #

方案1：切换到支持全局配置的持久化存储 #

如果业务允许，替换InMemory存储为支持全局过期配置的持久化存储（如SQL Server）：

1. 安装对应的NuGet包：Hangfire.SqlServer
2. 修改Program.cs中的Hangfire配置：

using Hangfire;

var builder = WebApplication.CreateBuilder(args);
// Add Hangfire services.
builder.Services.AddHangfire(configuration => configuration
    .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UseSqlServerStorage("你的数据库连接字符串") // 替换为实际连接字符串
    .WithJobExpirationTimeout(TimeSpan.FromDays(60))
);
// Add the processing server as IHostedService
builder.Services.AddHangfireServer();

var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.UseHangfireDashboard();
BackgroundJob.Enqueue(() => Console.WriteLine("Hello world from Hangfire!"));

app.Run();

方案2：单个作业级别设置过期时间 #

如果必须保留InMemory存储，只能为每个作业单独配置过期时间：

BackgroundJob.Enqueue(() => Console.WriteLine("Hello world from Hangfire!"), job => job
    .WithJobExpirationTimeout(TimeSpan.FromDays(60)));

该方式需要逐个作业配置，无法全局统一生效。

验证 #

修改配置后重启项目，访问Hangfire仪表盘，查看作业的过期时间是否已更新为60天。

内容的提问来源于stack exchange，提问作者user27465760