Hangfire无法入队作业：抽象类与DI配置问题排查

在使用Hangfire入队作业时，依赖注入（DI）未正常工作，框架尝试从接口实例化类，引发编译错误或运行时异常。Hangfire无法直接创建抽象类的实例，导致作业入队失败。错误截图如下：

请问当前配置中缺失了什么？

当前配置代码如下：

{
    var builder = Host.CreateDefaultBuilder(args);

    builder.ConfigureServices(services =>
    {
        services
            .AddOptions<DatabaseOptions>()
            .BindConfiguration(DatabaseOptions.ConfigKey)
            .ValidateDataAnnotations()
            .ValidateOnStart();


        services.AddDbContextPool<AppDbContext>((provider, builder) =>
        {
            var dbOptions = provider
                .GetRequiredService<IOptions<DatabaseOptions>>()
                .Value;

                builder
                    .UseNpgsql(dbOptions.Postgres.ConnectionString,
                        options => { options.CommandTimeout(dbOptions.Postgres.CommandTimeoutInSeconds); })
                    .UseSnakeCaseNamingConvention();
      
        });

        services.AddDbContext<EventStoreDbContext>((provider, builder) =>
        {
            var dbOptions = provider
                .GetRequiredService<IOptions<DatabaseOptions>>()
                .Value;
                builder
                    .UseNpgsql(dbOptions.Postgres.ConnectionString,
                        options => { options.CommandTimeout(dbOptions.Postgres.CommandTimeoutInSeconds); })
                    .UseSnakeCaseNamingConvention();
        });

        services.AddHangfire((provider, configuration) =>
        {
            var dbOptions = provider.GetRequiredService<IOptions<DatabaseOptions>>().Value;

            configuration.SetDataCompatibilityLevel(CompatibilityLevel.Version_170);

        services.AddHangfireServer((provider, globalConfig) =>
        {
           
        });

        services.AddTransient<IEventRepository, EventRepository>();
        
        services.AddBlockchainInfrastructure();
      
    });

    return builder;
}

问题根源与缺失配置 #

你的配置存在三个关键问题：

1. 未配置Hangfire存储后端
   仅设置数据兼容性级别不足以让Hangfire正常工作，必须指定作业数据的存储介质（这里是PostgreSQL）。缺少存储配置会导致Hangfire无法持久化作业信息，进而引发依赖解析失败。

   需在AddHangfire的配置委托中添加PostgreSQL存储配置：

   configuration.UseNpgsqlStorage(dbOptions.Postgres.ConnectionString, new NpgsqlStorageOptions
   {
       CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
       SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
       UseRecommendedIsolationLevel = true
   });
   

2. AddHangfireServer注册位置错误
   你将AddHangfireServer嵌套在了AddHangfire的委托内部，这是语法错误，会导致服务注册逻辑异常。需要将其移到AddHangfire外部，与其他服务注册同级：

   services.AddHangfire((provider, configuration) =>
   {
       var dbOptions = provider.GetRequiredService<IOptions<DatabaseOptions>>().Value;
       configuration.SetDataCompatibilityLevel(CompatibilityLevel.Version_170);
       configuration.UseNpgsqlStorage(dbOptions.Postgres.ConnectionString);
   });
   
   // 正确注册Hangfire Server
   services.AddHangfireServer();
   

3. 作业依赖的解析逻辑缺失
   若作业类依赖IEventRepository这类接口，需确保：

   • 作业类本身已注册到DI容器（如services.AddTransient<YourJobClass>()）
   • 入队作业时通过DI解析实例，而非直接传入接口类型：

     var jobInstance = serviceProvider.GetRequiredService<YourJobClass>();
     BackgroundJob.Enqueue(() => jobInstance.ExecuteJob());
     

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