.NET Core中如何Mock HttpClient的SendAsync方法并注入ServiceCollection

一、将Mock的IHttpClientFactory注入ServiceCollection的方法 #

你只需要将构造好的mock工厂作为单例注册到ServiceCollection中，替换原生的IHttpClientFactory实现即可，示例代码如下：

// 你已有的Mock代码
var mockFactory = new Mock<IHttpClientFactory>();
var mockHttpMessageHandler = new Mock<HttpMessageHandler>();
mockHttpMessageHandler.Protected()
    .Setup<Task<HttpResponseMessage>>("SendAsync", ItExpr.IsAny<HttpRequestMessage>(), ItExpr.IsAny<CancellationToken>())
    .ReturnsAsync(new HttpResponseMessage
    {
        StatusCode = HttpStatusCode.OK,
        // 注意原代码中JSON的thecodebuzz缺少引号，这里补充避免解析错误
        Content = new StringContent("{'name':'thecodebuzz','city':'USA'}"),
    });

var client = new HttpClient(mockHttpMessageHandler.Object)
{
    BaseAddress = new Uri("myurl.com") // 统一配置业务需要的BaseAddress
};
mockFactory.Setup(_ => _.CreateClient(It.IsAny<string>())).Returns(client);

// 核心注入逻辑
var services = new ServiceCollection();
// 先注册你的其他业务服务
// 替换IHttpClientFactory的实现为Mock实例
services.AddSingleton<IHttpClientFactory>(mockFactory.Object);

// 构建容器后即可正常使用
var serviceProvider = services.BuildServiceProvider();

注意：如果你的业务代码使用了命名客户端/类型化客户端，只需要调整CreateClient的匹配规则，对应特定客户端名称返回对应配置的Mock HttpClient即可。

二、更简单的实现方案 #

推荐使用Moq.Contrib.HttpClient扩展库简化Mock逻辑，不需要手动处理HttpMessageHandler的Protected方法反射调用，代码可读性和维护性更高：

步骤1：安装对应NuGet包 #

Install-Package Moq.Contrib.HttpClient

步骤2：简化后的Mock+注入代码 #

var mockHandler = new Mock<HttpMessageHandler>();
// 直接匹配请求规则设置返回，无需编写反射相关代码
mockHandler.SetupRequest(HttpMethod.Get, "myurl.com/myendpoint")
    .ReturnsResponse(HttpStatusCode.OK, "{'name':'thecodebuzz','city':'USA'}", "application/json");

// 直接注册到ServiceCollection
var services = new ServiceCollection();
services.AddHttpClient("", client =>
{
    client.BaseAddress = new Uri("myurl.com");
}).AddHttpMessageHandler(() => mockHandler.Object);

// 业务代码中正常注入IHttpClientFactory即可拿到Mock后的实例

如果是测试场景，还可以配合WebApplicationFactory直接替换真实启动服务中的HttpClient实现，无需手动修改ServiceCollection注册逻辑。

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