如何用Moq框架模拟C#中HttpClient.Send方法并验证调用？

一、URL的选择原则 #

只要使用不会触发真实网络请求的无效/占位地址即可，推荐这几种：

• http://example.invalid：IANA官方保留的无效域名，绝对不会解析到真实服务，是最安全的选择
• http://localhost/fake-endpoint：本地无对应服务的地址，不会发起有效请求
• http://fake-test-url：任意虚构的非真实域名/地址

这些地址仅作占位用，因为我们会通过Moq拦截所有请求，不会真的发送到目标地址。

二、完整测试代码实现 #

要验证HttpClient.Send的调用，正确做法是通过MockHttpMessageHandler来拦截请求（HttpClient的所有请求最终都会委托给HttpMessageHandler处理），示例代码如下：

using Moq;
using Moq.Protected;
using System.Net;
using System.Net.Http;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

// 1. 创建HttpMessageHandler的Mock实例，拦截请求
var handlerMock = new Mock<HttpMessageHandler>(MockBehavior.Strict);

// 2. 模拟SendAsync方法（同步Send内部会调用此异步方法），返回假响应
handlerMock.Protected()
    .Setup<Task<HttpResponseMessage>>(
        "SendAsync",
        ItExpr.IsAny<HttpRequestMessage>(),
        ItExpr.IsAny<CancellationToken>())
    .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));

// 3. 用Mock的Handler创建HttpClient
var httpClient = new HttpClient(handlerMock.Object);

// 4. 执行被测逻辑（模拟你的业务代码）
var request = new HttpRequestMessage(HttpMethod.Post, "http://example.invalid")
{
    Content = new StringContent("fake content", Encoding.UTF8, "application/json")
};
httpClient.Send(request);

// 5. 验证请求是否被调用（间接验证Send方法的执行）
handlerMock.Protected()
    .Verify(
        "SendAsync",
        Times.Once(), // 验证调用次数为1次
        ItExpr.Is<HttpRequestMessage>(req => 
            req.RequestUri.ToString() == "http://example.invalid" && 
            req.Method == HttpMethod.Post), // 可额外验证请求的URL、方法等细节
        ItExpr.IsAny<CancellationToken>());

三、关键说明 #

• 无需纠结URL的具体内容，只要是无效地址即可，核心是通过HttpMessageHandler的Mock拦截所有请求，避免真实网络调用
• 如果业务代码通过依赖注入获取HttpClient，测试时直接传入Mock好的HttpClient实例即可
• 验证SendAsync的调用等同于验证Send的执行，因为同步Send方法内部会调用异步的SendAsync

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