MockHttp库中GetMatchCount方法使用注意事项

MockHttp是一个用于.NET单元测试中模拟HTTP请求的流行库。在使用过程中，开发者可能会遇到GetMatchCount方法返回结果与预期不符的情况。本文将深入分析这一现象的原因，并提供正确的使用方法。

问题现象

当开发者尝试使用自定义的IMockedRequest实现类来统计匹配请求数量时，可能会发现GetMatchCount方法总是返回0，即使明显有请求已经匹配。例如：

// 自定义匹配所有请求的实现
public class AnyMockedRequest : IMockedRequest
{
    public static readonly AnyMockedRequest AtAll = new();
    
    public bool Matches(HttpRequestMessage request) => true;
    // 其他实现...
}

// 使用示例
var handler = new MockHttpMessageHandler();
handler.When(HttpMethod.Get, "https://customers.com").Respond(HttpStatusCode.OK);

var client = handler.ToHttpClient();
await client.GetAsync("https://customers.com");

// 这里会返回0，不符合预期
int count = handler.GetMatchCount(AnyMockedRequest.AtAll); 

原因分析

MockHttp内部的工作机制是：当调用When/Respond方法设置请求模拟时，库会创建一个内部IMockedRequest实例并记录所有匹配该模式的请求。GetMatchCount方法实际上是查询这个内部实例的匹配计数，而不是重新评估所有历史请求。

因此，直接传入自定义的IMockedRequest实现不会得到预期的结果，因为库内部维护的是另一套匹配记录系统。

正确使用方法

要正确统计匹配请求数量，应该保存When/Respond方法返回的IMockedRequest实例，然后对该实例调用GetMatchCount：

var handler = new MockHttpMessageHandler();

// 保存返回的模拟请求实例
var mockedRequest = handler.When(HttpMethod.Get, "https://customers.com")
                          .Respond(HttpStatusCode.OK);

var client = handler.ToHttpClient();
await client.GetAsync("https://customers.com");

// 使用保存的实例查询匹配数
int count = handler.GetMatchCount(mockedRequest); // 现在会返回1

最佳实践

1. 保存模拟请求实例：始终保存When/Respond方法返回的IMockedRequest实例，以便后续验证

2. 明确验证目标：在单元测试中，明确要验证的是哪个具体的模拟请求

3. 避免过度通用匹配：虽然可以创建匹配所有请求的实现，但在实际测试中应该明确指定预期的请求模式

4. 结合其他验证方法：除了GetMatchCount，还可以使用GetMatchCountAsync或直接检查响应内容来全面验证请求

总结

理解MockHttp内部如何记录和统计请求匹配是正确使用GetMatchCount方法的关键。通过保存When/Respond返回的实例，开发者可以准确验证测试中的HTTP请求是否按预期执行。这种设计实际上提供了更精确的验证能力，可以针对每个具体的模拟请求进行独立的匹配统计。