Hangfire中SchedulePollingInterval等参数差异及数据库调用异常排查

问题背景 #

在Azure Application Insight「应用程序地图>性能排查」页面中，观察到服务每5分钟会触发1到9次来自Hangfire的数据库调用。日志时间戳如下：

10/25/2022, 10:57:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:52:10 PM
10/25/2022, 10:47:10 PM

注释Hangfire代码后，此类数据库调用完全消失，确认问题由Hangfire引发。

配置情况与疑问 #

当前使用.NET 6，需求是让Hangfire每小时检查一次队列，已尝试将SchedulePollingInterval、HeartbeatInterval、ServerCheckInterval都设为TimeSpan.FromHours(1)，但对这三个参数的具体区别不清楚，且官方文档相关说明不足。此前的配置代码如下：

builder.Services.AddHangfireServer(
    options => {
        options.WorkerCount = 1;
        options.SchedulePollingInterval = TimeSpan.FromMinutes(10);
        options.HeartbeatInterval = TimeSpan.FromMinutes(10);
        options.ServerCheckInterval = TimeSpan.FromMinutes(10);
    }
);

app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    StatsPollingInterval = 600000   
});

三个核心参数的差异 #

• SchedulePollingInterval：控制Hangfire服务器轮询定时任务队列的间隔，专门用于检测是否有到期需要执行的定时任务（比如RecurringJob）。设置为1小时后，服务器每小时仅会查询一次数据库中的待执行定时任务。
• HeartbeatInterval：Hangfire服务器向数据库发送心跳的间隔，目的是标记自身处于活跃状态。其他服务器或Dashboard会通过这个心跳记录判断当前服务器是否在线。这个操作会产生数据库写入请求，但和队列检查无关。
• ServerCheckInterval：服务器检查其他Hangfire服务器状态的间隔，比如检测是否有服务器离线，并清理离线服务器的残留数据。该操作会查询数据库中的服务器状态表，同样会产生数据库调用，但也不直接影响队列检查逻辑。

5分钟调用问题的排查方向 #

如果已经将三个参数设为1小时，但仍出现5分钟一次的数据库调用，建议排查以下几点：

1. 是否存在其他运行中的Hangfire服务器实例，这些实例可能使用了默认配置（默认SchedulePollingInterval为5分钟）
2. 确认修改后的配置是否真正生效，比如是否重新部署了服务，或者配置代码是否被正确加载
3. 检查是否有RecurringJob的单独配置覆盖了全局轮询间隔，或是使用了其他触发机制导致额外的数据库查询

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