策略设计模式场景下Hangfire Server无法拾取作业的问题咨询

我之前也碰到过类似的Hangfire架构下策略模式失效的问题，结合你的MVC客户端+控制台服务端+共享类库的架构，大概率是序列化/反序列化或者类型解析相关的问题，咱们一步步来排查解决：

1. 优先排查序列化的多态支持问题 #

Hangfire默认的序列化器（早期是Json.NET，新版本可能用System.Text.Json）在处理策略模式的接口/抽象类时，很容易丢失具体实现类的类型信息，导致服务端无法反序列化作业参数。

解决方法： #

• 如果用的是Json.NET（Hangfire < 1.8版本），在客户端和服务端都配置序列化保留类型信息：

  // MVC客户端启动时配置
  GlobalConfiguration.Configuration.UseJsonSerializerSettings(new JsonSerializerSettings
  {
      TypeNameHandling = TypeNameHandling.All,
      ReferenceLoopHandling = ReferenceLoopHandling.Ignore
  });
  
  // 控制台服务端启动时同样配置
  GlobalConfiguration.Configuration.UseJsonSerializerSettings(new JsonSerializerSettings
  {
      TypeNameHandling = TypeNameHandling.All
  });
  

• 如果是Hangfire 1.8+用System.Text.Json，要配置多态类型解析：

  var options = new JsonSerializerOptions
  {
      IncludeFields = true,
      TypeInfoResolver = new DefaultJsonTypeInfoResolver
      {
          Modifiers =
          {
              typeInfo =>
              {
                  if (typeInfo.Type == typeof(IStrategy)) // 替换为你的策略接口
                  {
                      typeInfo.PolymorphismOptions = new JsonPolymorphismOptions
                      {
                          TypeDiscriminatorPropertyName = "$type",
                          IgnoreUnrecognizedTypeDiscriminators = true,
                          DerivedTypes =
                          {
                              new JsonDerivedType(typeof(ConcreteStrategy1), nameof(ConcreteStrategy1)),
                              new JsonDerivedType(typeof(ConcreteStrategy2), nameof(ConcreteStrategy2))
                          }
                      };
                  }
              }
          }
      }
  };
  GlobalConfiguration.Configuration.UseSystemTextJson(options);
  

2. 确认作业提交的方式正确 #

如果你在MVC客户端提交作业时直接用了接口类型，比如：

// 错误示例：直接用接口提交
BackgroundJob.Enqueue<IStrategy>(x => x.Execute());

Hangfire无法知道要实例化哪个具体的策略实现类，服务端自然拾取不到作业。

解决方法： #

• 提交作业时指定具体的策略实现类：

  // 正确示例：用具体实现类提交
  BackgroundJob.Enqueue<ConcreteStrategy1>(x => x.Execute());
  

• 如果是依赖注入场景，确保客户端和服务端的DI容器都能正确解析对应的策略类型，并且提交作业时传递的是容器管理的实例（或者用Hangfire的DI集成来解析）。

3. 检查服务端的程序集引用 #

控制台作为Hangfire Server，必须能加载到共享类库中的所有策略实现类。如果你的控制台应用只是间接引用共享类库（比如通过MVC项目引用），可能会导致服务端找不到类型。

解决方法： #

• 直接在控制台应用项目中添加对共享类库的引用；
• 如果是动态加载的策略类，在控制台启动时显式加载对应的程序集：

  // 控制台启动时加载共享类库程序集
  Assembly.Load("Your.Shared.Strategy.Library");
  

4. 验证Hangfire Server的队列配置 #

如果客户端把作业放到了自定义队列，而服务端没有监听该队列，也会出现无法拾取的情况。

解决方法： #

• 检查客户端提交作业时指定的队列：

  // 客户端指定队列
  BackgroundJob.Enqueue<ConcreteStrategy1>(x => x.Execute(), queue: "strategy-jobs");
  

• 在控制台服务端启动时确保监听对应的队列：

  var serverOptions = new BackgroundJobServerOptions
  {
      Queues = new[] { "default", "strategy-jobs" } // 包含客户端使用的队列
  };
  using var server = new BackgroundJobServer(serverOptions);
  

5. 利用Hangfire仪表盘定位具体错误 #

你的MVC应用托管了仪表盘，这是最直接的排查工具：

1. 访问仪表盘的Failed Jobs标签；
2. 查看失败作业的异常堆栈信息，通常会明确提示“无法找到类型XXX”或“反序列化失败”，根据这个信息精准修复问题。

内容的提问来源于stack exchange，提问作者I Love Stackoverflow