HangFire Enqueue在Startup.cs中抛出System.ArgumentNullException问题排查

Hangfire后台任务运行在独立的后台线程中，没有关联ASP.NET Core HTTP请求上下文，而你注册IUrlHelper的逻辑强依赖IActionContextAccessor.ActionContext——这个值只有在HTTP请求处理过程中才会存在，所以当Hangfire尝试解析依赖时，就会因为actionContext为null抛出System.ArgumentNullException。

方法1：修改IUrlHelper注册逻辑，适配无HTTP上下文场景 #

在注册IUrlHelper时添加空值判断，当ActionContext为null时手动构建一个基础上下文，避免空引用：

services.AddScoped<IUrlHelper>(factory =>
{
    var actionContextAccessor = factory.GetService<IActionContextAccessor>();
    var actionContext = actionContextAccessor?.ActionContext;

    if (actionContext == null)
    {
        // 手动构建空ActionContext用于非HTTP场景
        var httpContextAccessor = factory.GetService<IHttpContextAccessor>();
        var httpContext = httpContextAccessor?.HttpContext ?? new DefaultHttpContext();
        actionContext = new ActionContext(httpContext, new RouteData(), new ActionDescriptor());
    }

    var urlHelperFactory = factory.GetRequiredService<IUrlHelperFactory>();
    return urlHelperFactory.GetUrlHelper(actionContext);
});

方法2：将后台任务与HTTP上下文解耦 #

如果SendTextsForRequest使用IUrlHelper是为了生成URL，建议提前在HTTP请求上下文内生成好所需URL，作为参数传入后台任务；或者创建不依赖IActionContextAccessor的独立URL生成服务：

public interface IUrlGenerator
{
    string GenerateUrl(string routeName, object routeValues);
}

public class UrlGenerator : IUrlGenerator
{
    private readonly LinkGenerator _linkGenerator;
    private readonly IConfiguration _config;

    public UrlGenerator(LinkGenerator linkGenerator, IConfiguration config)
    {
        _linkGenerator = linkGenerator;
        _config = config;
    }

    public string GenerateUrl(string routeName, object routeValues)
    {
        // 从配置读取站点基础地址，避免依赖HTTP上下文
        var baseUrl = _config["AppSettings:BaseUrl"];
        return _linkGenerator.GetUriByRouteValues(baseUrl, routeName, routeValues);
    }
}

在Startup中注册该服务：

services.AddScoped<IUrlGenerator, UrlGenerator>();

之后在SendTextsForRequest中注入IUrlGenerator替代IUrlHelper，即可在后台任务中正常生成URL。

注意事项 #

确保SendTextsForRequest的所有依赖项都能在无HTTP上下文的环境中被解析，避免依赖仅存在于HTTP请求生命周期内的服务。

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