ASP.NET Core 6 Web API服务描述符验证HttpClient解析错误

问题场景 #

• 项目为ASP.NET Core 6 Web API，使用Hangfire实现每日凌晨2点拉取第三方API账户余额入库的后台定时任务，任务不对外暴露控制器接口
• 已完成的开发内容：
  • 在appsettings.json中配置第三方余额查询接口地址accountBalanceUrl
  • 定义第三方接口返回结构BalanceEnquiryResponseDto、BalanceListDto，以及通用返回类BaseResponse
  • 编写IAccountBalanceService接口及实现类AccountBalanceService，构造函数声明依赖IMapper、IUnitOfWork、ILogger、IConfiguration、HttpClient实例，实现拉取接口数据、反序列化后批量写入CustomerBalance表的业务逻辑
  • 编写Hangfire服务扩展类，完成基于SQL Server的Hangfire存储、服务端相关配置
  • 在Program.cs中调用扩展方法注册Hangfire服务，以Scoped生命周期注册IAccountBalanceService与AccountBalanceService，启用Hangfire面板，配置每日2点执行的RecurringJob定时任务
• 异常表现：项目可正常编译，IIS Express在Visual Studio中启动时抛出System.AggregateException，核心错误信息：

验证服务描述符'ServiceType: IAccountBalanceService Lifetime: Scoped ImplementationType: AccountBalanceService'时出错，激活AccountBalanceService时无法解析System.Net.Http.HttpClient类型的服务

问题根因 #

ASP.NET Core内置依赖注入容器默认不会自动注册无类型的裸HttpClient实例，直接在服务构造函数中声明注入HttpClient时，容器找不到对应已注册的服务实例，就会抛出服务解析失败异常。

修复方案 #

可根据实际场景二选一：

方案1：使用IHttpClientFactory创建HttpClient（官方推荐） #

1. 首先在Program.cs服务注册阶段，添加HttpClient基础服务注册：

// 注册HttpClient工厂
builder.Services.AddHttpClient();

2. 修改AccountBalanceService构造函数的依赖声明，将直接注入HttpClient改为注入IHttpClientFactory，在构造函数中通过工厂创建HttpClient实例：

public class AccountBalanceService : IAccountBalanceService
{
    private readonly HttpClient _httpClient;
    private readonly IMapper _mapper;
    private readonly IUnitOfWork _unitOfWork;
    private readonly ILogger<AccountBalanceService> _logger;
    private readonly IConfiguration _configuration;

    public AccountBalanceService(
        IHttpClientFactory httpClientFactory,
        IMapper mapper,
        IUnitOfWork unitOfWork,
        ILogger<AccountBalanceService> logger,
        IConfiguration configuration)
    {
        _httpClient = httpClientFactory.CreateClient();
        _mapper = mapper;
        _unitOfWork = unitOfWork;
        _logger = logger;
        _configuration = configuration;
    }

    // 其余业务拉取、入库逻辑保持原有实现即可
}

方案优势：由框架统一管理HttpClient的生命周期，可有效避免手动创建客户端导致的套接字耗尽、DNS变更不感知等常见问题，是生产环境优先选择的实现方式。

方案2：手动注册HttpClient实例到DI容器 #

如果不想改动现有AccountBalanceService的构造函数逻辑，可直接在服务注册阶段手动注入配置好的HttpClient实例：
在Program.cs服务注册区块添加如下代码：

builder.Services.AddScoped(sp => 
{
    var httpClient = new HttpClient();
    // 可在此统一配置超时、默认请求头、基础地址等参数
    // httpClient.Timeout = TimeSpan.FromSeconds(30);
    return httpClient;
});

注意：该方式需要自行管控HttpClient生命周期，配置不当容易引发套接字耗尽问题，仅适合临时快速修复场景，不推荐生产环境长期使用。

额外配置注意 #

Hangfire执行Scoped生命周期服务的定时任务时，不要直接从应用根容器解析服务，否则会抛出Scoped服务跨作用域解析异常。注册RecurringJob时使用泛型版本的方法即可，Hangfire会自动为每次任务执行创建独立的服务作用域，正确注册示例：

RecurringJob.AddOrUpdate<IAccountBalanceService>(
    recurringJobId: "Daily_Pull_Account_Balance",
    methodCall: service => service.PullAndSaveBalanceAsync(),
    cronExpression: "0 0 2 * * ?", // Cron表达式，对应每日凌晨2点执行
    timeZone: TimeZoneInfo.Local);

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