.NET 6中多个Hangfire循环任务无法调度问题求助

核心问题分析 #

报错根源是System.TypeLoadException：Hangfire无法加载BackgroundJobs.ProcessAndSendNotifications类型，导致定时任务调度失败；而Azure App Service的闲置机制会导致Hangfire Server在45分钟后休眠，任务停止运行。

分步解决方案 #

1. 修复类型加载失败问题 #

• 校验类型与程序集匹配
  确认BackgroundJobs.ProcessAndSendNotifications类的命名空间、类名无拼写错误，且该类确实存在于PortCall.Info程序集中；若类被迁移到其他程序集，需同步更新Hangfire任务注册逻辑。同时确保该类为public访问修饰符，Hangfire需要访问公共类型的公共方法。

• 清理Hangfire存储中的无效任务
  旧的任务记录（如已删除/重命名的ProcessAndSendNotifications任务）仍会被Hangfire调度，需手动清理：

  • 通过Hangfire Dashboard（/scheduler）找到对应错误任务，直接删除
  • 若使用SqlServer存储，执行SQL清理（谨慎操作）：

    -- 删除指定无效任务
    DELETE FROM Hangfire.RecurringJob WHERE Id = '报错任务的ID';
    -- 或批量删除包含目标类型的任务
    DELETE FROM Hangfire.RecurringJob WHERE JobType LIKE '%ProcessAndSendNotifications%';
    

• 优化任务注册方式
  避免使用静态方法注册任务，改用依赖注入的实例方式，确保Hangfire能正确解析类型：

  // 先将任务类注册到DI容器
  services.AddScoped<IJobs, Jobs>();
  
  // 替换静态方法注册为实例方法
  RecurringJob.AddOrUpdate<IJobs>(
      "Mondays",
      job => job.CruiseReport(),
      "0 6 * * MON");
  

2. 解决Azure App Service任务停止问题 #

• 开启"始终开启"功能
  在Azure门户进入你的App Service -> 配置 -> 常规设置，将"始终开启"设置为开启，防止应用因闲置被休眠。

• 配置定时唤醒请求
  添加健康检查接口（如/health），使用Azure Monitor或定时任务工具（如Azure Logic Apps）每隔15-20分钟访问该接口，保持应用活跃。

• 调整Hangfire Server配置
  延长服务器超时时间并调整工作线程数，适配Azure环境：

  services.AddHangfireServer(options =>
  {
      options.WorkerCount = Environment.ProcessorCount * 2; // 根据CPU核心数调整
      options.ServerTimeout = TimeSpan.FromMinutes(60); // 延长超时至60分钟
  });
  

3. 验证部署完整性 #

• 检查Azure部署包中的PortCall.Info.dll是否包含最新的ProcessAndSendNotifications类，可通过Kudu控制台（https://<app-name>.scm.azurewebsites.net/DebugConsole）查看程序集内容。
• 开启App Service的应用日志，查看程序集加载阶段是否存在其他异常。

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