Hangfire指定时段的定时任务未执行，求助排查原因

1. Cron表达式逻辑冲突（针对任务X） #

你给任务X设置的Cron表达式0 10 8 8 */1存在逻辑问题：Hangfire依赖的NCrontab库中，日和星期字段是逻辑与的关系——只有当日期是8月8日，且当天的星期数匹配*/1时才会触发。虽然*/1在星期字段表示“所有星期几”，但这种写法容易引发解析歧义。如果你的需求是“8月8日10点执行，不管当天是星期几”，正确写法应该用?忽略星期字段：

RecurringJob.AddOrUpdate<TaskExecutor>("X", x => x.RunTask("One Time 1"), "0 10 8 8 ?");

2. 时区不匹配（最常见的核心问题） #

Hangfire默认用UTC时间解析Cron表达式，如果你预期的是本地时间（比如北京时间），两者会存在时差。比如你设置的“上午10点”，在UTC时间里是凌晨2点，自然不会在你预期的时间触发。

解决方法：添加任务时显式指定目标时区：

// 替换为你需要的时区ID，比如北京时间是"China Standard Time"
var targetTimeZone = TimeZoneInfo.FindSystemTimeZoneById("China Standard Time");

RecurringJob.AddOrUpdate<TaskExecutor>("X", x => x.RunTask("One Time 1"), "0 10 8 8 ?", targetTimeZone);
RecurringJob.AddOrUpdate<TaskExecutor>("Z", x => x.RunTask("One Time 2"), "0 10 * * *", targetTimeZone);

3. 错过任务未配置重试策略 #

如果你的Hangfire服务器是在2023年8月8日10点之后才启动，默认情况下Hangfire不会执行错过的定时任务。需要配置错过任务的处理策略：

var jobOptions = new RecurringJobOptions
{
    MisfireHandling = MisfireHandlingMode.RunOnce
};

RecurringJob.AddOrUpdate<TaskExecutor>("X", x => x.RunTask("One Time 1"), "0 10 8 8 ?", targetTimeZone, jobOptions);

MisfireHandlingMode.RunOnce会让错过的任务在服务器启动后立即执行一次。

4. 内存存储导致任务丢失 #

你当前用的是Hangfire默认的内存存储，如果服务器重启或进程意外终止，所有定时任务都会被清空。如果你的服务器在8月8日10点前重启过，任务X和Z会丢失，自然不会触发。

解决方法：配置持久化存储（如SQL Server、Redis），确保任务在服务器重启后依然存在。以SQL Server为例：

// 先安装NuGet包：Hangfire.SqlServer
GlobalConfiguration.Configuration.UseSqlServerStorage("你的数据库连接字符串");

using var server = new BackgroundJobServer();

5. 验证Cron表达式的有效性 #

可以用NCrontab的代码验证表达式是否会在预期时间触发：

using NCrontab;

var cron = CrontabSchedule.Parse("0 10 8 8 ?");
var nextRunTime = cron.GetNextOccurrence(DateTime.Now, TimeZoneInfo.FindSystemTimeZoneById("China Standard Time"));
Console.WriteLine(nextRunTime);

如果输出时间不是2023年8月8日10点，说明表达式存在问题。

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