Typed HttpClient注入异常：实例未包含配置的BaseUrl

调试时发现，获取到的HttpClient实例未携带预先配置好的基础URL，调用SendAsync方法时因缺少BaseAddress执行失败。相关代码如下：

服务接口 #

public interface IEmailer
{
    Task SendAsync();
}

服务实现 #

public class ApiEmail : IEmailer
{
    private readonly HttpClient _client;

    // 原代码构造函数名错误，应为ApiEmail而非SmtpEmail
    public SmtpEmail(HttpClient client)
    { 
        _client = client;
    }

    public async Task SendAsync()
    {
        // 此处失败：未定义基础URL
        var response = await _client.PostAsync("some/url/email");
    }
}

服务扩展方法 #

public static class IServiceCollectionExtensions
{
    public static void AddEmailer(this IServiceCollection services)
    {
        services.AddHttpClient<ApiEmailer>(client =>
        {
            client.BaseAddress = new Uri("https://somewebemail.com/api/");
        });
        services.AddSingleton<IEmailer, ApiEmailer>();
    }
}

Program.cs #

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);
    ...
    builder.Services.AddEmailer();
    ...
    app.Run();
}

控制器 #

public class WeatherForecastController : ControllerBase
{
    private readonly IEmailer _emailer;

    public WeatherForecastController(IEmailer emailer)
    {
        _emailer = emailer;
    }

    public async Task<IEnumerable<WeatherForecast>> Get()
    {
        await _emailer.SendAsync();
    }
}

问题根源 #

1. 构造函数名称错误：ApiEmail类的构造函数名与类名不符，DI无法正确识别并注入HttpClient（编译阶段会报错，原问题中能运行应为笔误）。
2. DI注册冲突：AddHttpClient<ApiEmailer>会生成一个带配置HttpClient的ApiEmailer transient实例，但后续AddSingleton<IEmailer, ApiEmailer>覆盖了接口注册逻辑。当DI解析IEmailer时，会直接创建新的ApiEmailer实例，注入的是无BaseAddress的默认HttpClient，而非预先配置好的实例。

解决方案 #

步骤1：修正构造函数名称

将构造函数名改为与类名一致：

public class ApiEmail : IEmailer
{
    private readonly HttpClient _client;

    public ApiEmail(HttpClient client)
    { 
        _client = client;
    }

    public async Task SendAsync()
    {
        var response = await _client.PostAsync("some/url/email");
    }
}

步骤2：统一DI注册方式

使用AddHttpClient的泛型重载直接关联接口与实现，同时配置HttpClient，移除单独的AddSingleton注册：

public static class IServiceCollectionExtensions
{
    public static void AddEmailer(this IServiceCollection services)
    {
        services.AddHttpClient<IEmailer, ApiEmailer>(client =>
        {
            client.BaseAddress = new Uri("https://somewebemail.com/api/");
        });
    }
}

原理说明 #

AddHttpClient<IEmailer, ApiEmailer>会自动完成两项操作：

• 注册IEmailer接口指向ApiEmailer实现，生命周期为transient；
• 为ApiEmailer注入预先配置好BaseAddress的HttpClient实例。

这样控制器请求IEmailer时，DI容器会提供带有正确BaseAddress的ApiEmail实例，调用SendAsync时即可正常拼接URL发起请求。

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