如何用Moq模拟C#中HttpClient的Send方法（非SendAsync）

针对你的需求，有两种可靠方案实现，无需修改原有代码，也不会发送真实请求：

方案1：直接Mock HttpClient的Send虚方法 #

HttpClient.Send(HttpRequestMessage)本身是虚方法，Moq可以直接模拟它，既可以预设返回结果，也能验证方法是否被调用：

// 初始化HttpClient的Mock实例
var mockHttpClient = new Mock<HttpClient>();

// 配置Send方法的行为：任意HttpRequestMessage都返回200响应
mockHttpClient.Setup(client => client.Send(It.IsAny<HttpRequestMessage>()))
              .Returns(new HttpResponseMessage(HttpStatusCode.OK));

// 将Mock实例注入到待测试的服务中
var targetService = new YourTargetService(mockHttpClient.Object);

// 执行测试逻辑
targetService.ExecuteMethodThatCallsSend();

// 验证Send方法是否按预期被调用（可根据需求调整参数匹配和调用次数）
mockHttpClient.Verify(client => client.Send(It.IsAny<HttpRequestMessage>()), Times.Once);

这种方式直接针对Send方法，逻辑清晰，适合原有代码依赖HttpClient实例注入的场景。

方案2：通过Mock HttpMessageHandler拦截请求 #

如果原有代码是直接创建HttpClient实例（比如new HttpClient()），可以给它传入一个模拟的HttpMessageHandler，拦截所有请求（包括Send和SendAsync触发的请求）：

// 创建HttpMessageHandler的Mock，严格模式确保未配置的方法不会被调用
var mockHandler = new Mock<HttpMessageHandler>(MockBehavior.Strict);

// 保护方法需要用Protected()来模拟，匹配SendAsync的参数
mockHandler.Protected()
           .Setup<Task<HttpResponseMessage>>(
               "SendAsync",
               ItExpr.IsAny<HttpRequestMessage>(),
               ItExpr.IsAny<CancellationToken>()
           )
           .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));

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

// 注入到待测试服务中
var targetService = new YourTargetService(httpClient);

// 执行测试逻辑
targetService.ExecuteMethodThatCallsSend();

// 验证请求被触发（因为Send同步方法内部会调用SendAsync）
mockHandler.Protected().Verify(
    "SendAsync",
    Times.Once,
    ItExpr.IsAny<HttpRequestMessage>(),
    ItExpr.IsAny<CancellationToken>()
);

URL选择建议 #

为了避免无效主机、连接失败等潜在问题（即使模拟逻辑已经拦截请求），可以使用以下两类URL：

• 本地回环地址：比如http://localhost:9999、https://localhost:5001，这类地址不会触发外部网络请求，即使端口未被监听也不会报错。
• 预留无效域名：比如http://example.invalid，invalid是ICANN预留的无效后缀，不会被解析到真实IP，完全不会触发真实网络操作。

只要模拟逻辑配置正确，无论使用哪种URL，都不会发起真实请求，无需担心连接问题。

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