Hangfire中Scoped依赖注入与过滤器的实例不一致问题排查

核心问题在于全局过滤器的注册方式错误，导致过滤器从根服务容器获取实例，而作业则在独立的Scoped作用域内创建，两者自然拿到不同的Scoped服务实例。以下是具体的解决步骤：

1. 修正全局过滤器的注册方式 #

不要直接注册过滤器的实例，而是注册过滤器的类型。Hangfire会在作业执行的Scoped作用域内自动解析过滤器实例，这样就能和作业共享同一个Scoped服务。

错误的注册方式：

// 错误：直接实例化过滤器，会从根容器获取依赖，导致Scoped实例不共享
GlobalJobFilters.Filters.Add(new HangfireSessionFilter());

正确的注册方式：

// 正确：注册过滤器类型，Hangfire会在作业作用域内解析它
GlobalJobFilters.Filters.Add(typeof(HangfireSessionFilter));

2. 确保过滤器通过构造函数注入依赖 #

你的HangfireSessionFilter必须通过构造函数接收IUnitOfWork，这样Hangfire在解析过滤器时，会从当前作业的Scoped作用域中获取实例：

public class HangfireSessionFilter : IElectStateFilter, IApplyStateFilter
{
    private readonly IUnitOfWork _unitOfWork;

    // 构造函数注入IUnitOfWork，依赖容器会自动提供当前作用域的实例
    public HangfireSessionFilter(IUnitOfWork unitOfWork)
    {
        _unitOfWork = unitOfWork;
    }

    public void OnStateElection(ElectStateContext context)
    {
        // 作业启动时建立连接
        _unitOfWork.OpenConnection();
    }

    public void OnStateApplied(ApplyStateContext context, IWriteOnlyTransaction transaction)
    {
        // 作业完成（成功/失败）时关闭连接
        if (context.NewState is SucceededState or FailedState)
        {
            _unitOfWork.CloseConnection();
        }
    }

    public void OnStateUnapplied(ApplyStateContext context, IWriteOnlyTransaction transaction)
    {
        // 可选：处理状态取消的情况
    }
}

3. 确保IUnitOfWork注册为Scoped生命周期 #

在DI容器中必须将IUnitOfWork注册为Scoped，这样每个作业作用域都会创建一个独立实例，且过滤器和作业共享该实例：

services.AddScoped<IUnitOfWork, UnitOfWork>();

4. 无需自定义JobActivator（除非特殊场景） #

如果你使用的是Hangfire.AspNetCore，它已经内置了Scoped作用域的支持，不需要自定义JobActivator。自定义Activator反而可能破坏默认的作用域管理逻辑，导致实例不共享。

关键原理 #

当你注册过滤器类型时，Hangfire会在作业执行前创建一个Scoped作用域，然后在该作用域内同时解析作业实例和过滤器实例，两者自然共享同一个Scoped服务。而直接注册过滤器实例时，实例是从根容器创建的，根容器的Scoped服务本质上是单例，和作业的Scoped实例完全独立。

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