单元测试Mock IHttpClientFactory时HttpClient为空的解决方法

你遇到的问题核心是未给Mock的IHttpClientFactory设置CreateClient()方法的返回值，Moq默认会返回null，导致_httpClientFactory.CreateClient()得到的HttpClient为空。以下是正确的实现方案：

步骤1：创建可用于测试的HttpClient实例 #

你可以直接实例化基础HttpClient，或者用HttpMessageHandler模拟请求响应（如果需要测试HttpClient的请求逻辑）：

基础版本（仅需实例化HttpClient） #

var httpClient = new HttpClient();

带响应模拟的版本（用于测试请求返回逻辑） #

// 模拟HttpMessageHandler，控制HttpClient的响应内容
var mockHandler = new Mock<HttpMessageHandler>();
mockHandler.Protected()
    .Setup<Task<HttpResponseMessage>>(
        "SendAsync",
        ItExpr.IsAny<HttpRequestMessage>(),
        ItExpr.IsAny<CancellationToken>())
    .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK)
    {
        Content = new StringContent("模拟响应内容")
    });

// 使用模拟Handler创建HttpClient
var httpClient = new HttpClient(mockHandler.Object);

步骤2：配置Moq的IHttpClientFactory返回该HttpClient #

通过Moq的Setup方法指定CreateClient()的返回值：

var httpClientFactoryMock = new Mock<IHttpClientFactory>();
// 设置CreateClient方法返回我们准备好的HttpClient
httpClientFactoryMock.Setup(factory => factory.CreateClient(It.IsAny<string>()))
                    .Returns(httpClient);

注意：.NET官方的IHttpClientFactory接口定义的是CreateClient(string name)方法，你代码里的Create()属于笔误，需要和实际接口保持一致。

完整测试代码示例 #

修正后的xUnit测试代码如下：

[Fact]
public void CreateClient_ShouldReturnValidClient()
{
    // 1. 准备模拟的HttpClient
    var mockHandler = new Mock<HttpMessageHandler>();
    mockHandler.Protected()
        .Setup<Task<HttpResponseMessage>>(
            "SendAsync",
            ItExpr.IsAny<HttpRequestMessage>(),
            ItExpr.IsAny<CancellationToken>())
        .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));

    var testHttpClient = new HttpClient(mockHandler.Object);

    // 2. Mock IHttpClientFactory并设置返回值
    var httpClientFactoryMock = new Mock<IHttpClientFactory>();
    httpClientFactoryMock.Setup(f => f.CreateClient(It.IsAny<string>()))
                        .Returns(testHttpClient);

    // 3. 实例化待测试的ClientFactory
    var clientFactory = new ClientFactory(httpClientFactoryMock.Object);

    // 4. 执行测试方法
    var testConfig = new ClientConfiguration(); // 替换为你的实际配置对象
    var resultClient = clientFactory.CreateClient(testConfig);

    // 5. 断言结果（根据需求添加验证逻辑）
    Assert.NotNull(resultClient);
}

额外注意事项 #

• 修正代码笔误：ClientCofiguron应为ClientConfiguration，_httpClientFactory.Create()应为_httpClientFactory.CreateClient(string)，确保和官方接口定义一致。
• 如果你的Client类依赖HttpClient的配置（如BaseAddress、超时时间），可在测试前先配置好testHttpClient，保证测试场景符合预期。

内容的提问来源于stack exchange，提问作者Álvaro García