XUnit集成测试中Mock HttpClient SendAsync失效，真实请求仍被调用排查

1. 未替换Startup中的HttpClient注册 #

如果你的PaPdfApiService是通过依赖注入获取的HttpClient，但测试时没有覆盖原有的注册逻辑，就会默认使用真实的HttpClient实例。比如Startup里可能是这样注册的：

services.AddHttpClient<PaPdfApiService>(client => {
    client.BaseAddress = new Uri("https://external-service.com");
});

测试时需要用AddHttpClient的重载，将内部的HttpMessageHandler替换为Mock实现，而非直接Mock HttpClient本身——因为HttpClient的SendAsync最终调用的是内部HttpMessageHandler的逻辑。

2. 错误Mock了HttpClient而非HttpMessageHandler #

很多人会直接MockHttpClient，但默认的HttpClient.SendAsync并非虚方法，它实际是调用内部HttpMessageHandler的SendAsync方法。正确的做法是MockHttpMessageHandler，再用这个Handler创建HttpClient：

// 错误示例：直接Mock HttpClient，不会生效
var mockHttpClient = new Mock<HttpClient>();
// 正确示例：Mock HttpMessageHandler
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("Mocked Response")
    });
var httpClient = new HttpClient(mockHandler.Object);

3. 测试类未正确注入Mock的HttpClient到PaPdfApiService #

如果测试使用WebApplicationFactory，需要在ConfigureServices中替换原有的HttpClient注册：

var factory = new WebApplicationFactory<Startup>()
    .WithWebHostBuilder(builder => {
        builder.ConfigureServices(services => {
            // 移除原有的HttpClient注册
            var descriptor = services.SingleOrDefault(d => d.ServiceType == typeof(HttpClient) && 
                                                          d.ImplementationInstance?.GetType() == typeof(HttpClient));
            if (descriptor != null) services.Remove(descriptor);
            
            // 添加Mock的HttpClient
            var mockHandler = new Mock<HttpMessageHandler>();
            // 设置Mock逻辑...
            services.AddSingleton<HttpClient>(new HttpClient(mockHandler.Object));
            // 或者针对PaPdfApiService的HttpClient注册做替换
            services.AddHttpClient<PaPdfApiService>().ConfigurePrimaryHttpMessageHandler(() => mockHandler.Object);
        });
    });

如果是直接实例化PaPdfApiService，要确保传入的是Mock的HttpClient，而非让DI容器自动注入真实实例。

4. Mock的Setup匹配条件不匹配 #

如果你Mock的是特定的HttpRequestMessage，但实际代码发起的请求和Setup的条件不一致（比如请求地址、HttpMethod、Content内容不匹配），Mock就不会触发，转而使用真实的Handler发起请求。
可以检查Setup中的匹配条件，要么用ItExpr.IsAny<HttpRequestMessage>()做宽松匹配，要么更精准地匹配请求特征：

mockHandler.Protected()
    .Setup<Task<HttpResponseMessage>>("SendAsync", 
        ItExpr.Is<HttpRequestMessage>(req => req.Method == HttpMethod.Post && 
                                            req.RequestUri.ToString().Contains("/api/pdf")),
        ItExpr.IsAny<CancellationToken>())
    .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));

5. 未验证Mock是否被调用 #

测试后可以验证Mock是否被触发，以此确认问题出在匹配条件还是注册逻辑上：

mockHandler.Protected()
    .Verify("SendAsync", Times.Once(), ItExpr.IsAny<HttpRequestMessage>(), ItExpr.IsAny<CancellationToken>());

如果验证失败，说明要么Mock的条件和实际请求不匹配，要么HttpClient没有使用这个Mock Handler。

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