Nunit 3测试依赖IHttpClientFactory的.NET 6 Web API控制器

我正在开发一个依赖IHttpClientFactory进行外部API调用的.NET 6 Web API控制器，构造函数如下：

public MyController(IHttpClientFactory httpClientFactory)
{
  _httpClientFactory = httpClientFactory;
}

该控制器在Program.cs中向builder.Services添加HttpClient后可正常运行。但在测试时，我需要实例化控制器（如代码var controller = new MyController(httpClientFactory);），却因未配置IHttpClientFactory而报错。此前我用ConfigurationBuilder解决过appsettings.json的配置问题，但找不到类似的IHttpClientFactory配置方法，希望得到解决方法。

更新记录 #

• 20221024：我采用了Ruikai Feng的方案在测试中使用Mockoon，但意识到这不符合单元测试规范，目前正在调整方案。
• 20221019：我一直在用Moq模拟IHttpClientFactory，原本想要实例化它是为了调用Mockoon创建的模拟API，但至今无法成功调用，推测是未正确模拟该工厂。感谢所有反馈，问题仍在解决中。

一、单元测试：正确模拟IHttpClientFactory #

单元测试需要隔离外部依赖，核心是模拟HttpClient的响应行为，而非依赖真实服务：

1. 模拟HttpMessageHandler来预设外部API的返回内容：

var mockHandler = new Mock<HttpMessageHandler>();
mockHandler.Protected()
    .Setup<Task<HttpResponseMessage>>(
        "SendAsync",
        ItExpr.IsAny<HttpRequestMessage>(),
        ItExpr.IsAny<CancellationToken>())
    .ReturnsAsync(new HttpResponseMessage
    {
        StatusCode = HttpStatusCode.OK,
        Content = new StringContent("{\"data\":\"模拟返回内容\"}")
    });

2. 基于模拟的HttpMessageHandler创建HttpClient，再让IHttpClientFactory返回这个实例：

var httpClient = new HttpClient(mockHandler.Object);
var mockHttpClientFactory = new Mock<IHttpClientFactory>();
mockHttpClientFactory.Setup(_ => _.CreateClient(It.IsAny<string>())).Returns(httpClient);

3. 用模拟的工厂实例化控制器：

var controller = new MyController(mockHttpClientFactory.Object);

这种方式完全隔离外部服务，符合单元测试的规范。

二、集成测试：用真实HttpClient调用Mockoon #

如果需要验证完整的HTTP请求流程（属于集成测试范畴），可以直接配置真实HttpClient指向Mockoon服务：

1. 创建指向Mockoon地址的HttpClient：

var httpClient = new HttpClient
{
    BaseAddress = new Uri("http://localhost:3000") // 替换为你的Mockoon服务地址
};

2. 配置IHttpClientFactory返回该实例，也可以用依赖注入容器简化配置：

// 方式1：用Moq快速模拟
var mockFactory = new Mock<IHttpClientFactory>();
mockFactory.Setup(_ => _.CreateClient(It.IsAny<string>())).Returns(httpClient);

// 方式2：用.NET测试容器（更贴近真实环境）
var services = new ServiceCollection();
services.AddHttpClient("MockoonClient", client =>
{
    client.BaseAddress = new Uri("http://localhost:3000");
});
var serviceProvider = services.BuildServiceProvider();
var httpClientFactory = serviceProvider.GetRequiredService<IHttpClientFactory>();

3. 用上述工厂实例化控制器即可完成集成测试。

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