单元测试使用localhost发送HTTP请求无法连接远程服务器如何修复

核心思路：不需要修改现有待测试的SomeHandlerThatAddHeader逻辑，也不需要调整原有测试的核心流程，只需要在Handler链的末尾添加一个短路测试Handler，拦截所有向外的真实网络请求，直接返回模拟响应即可，完美适配你不想改URI、不想高成本Mock的需求。

问题根因说明 #

原有测试之所以旧代理能跑、新代理失败，是因为旧的构建代理环境上碰巧有监听80端口的服务，所以请求不会被拒；新代理没有监听80端口的进程，就会抛出连接被拒的异常。本质问题是单元测试依赖了不可控的外部环境（本地端口监听状态、网络），短路Handler方案从根本上解决了这个依赖问题。

实现步骤 #

• 第一步：编写一个极简的短路Handler，用于终止请求链路、不发起真实网络调用

public class TestShortCircuitHandler : DelegatingHandler
{
    // 可选：把处理后的请求存下来，方便直接断言头部，比校验响应更准确
    public HttpRequestMessage LastProcessedRequest { get; private set; }

    protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        LastProcessedRequest = request;
        // 直接返回模拟的200响应，不发起任何真实网络请求
        return Task.FromResult(new HttpResponseMessage(System.Net.HttpStatusCode.OK));
    }
}

• 第二步：修改测试类中HttpClient的初始化逻辑，把自定义的短路Handler加到待测试Handler的后面，形成链式调用

// 先执行待测试的SomeHandlerThatAddHeader，再执行短路Handler终止请求
var testHandler = new TestShortCircuitHandler();
client = HttpClientFactory.Create(new SomeHandlerThatAddHeader(), testHandler);

• 第三步：原有测试逻辑几乎不用改，你可以选择继续用原来的断言逻辑，也可以直接用短路Handler存下来的请求做头部校验：

public async Task HeaderNotFound()
{
    var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost");
    // ...设置操作上下文
    await client.SendAsync(request, CancellationToken.None);
    // 直接从短路Handler取处理后的请求，断言头部是否正确添加
    Assert.NotNull(testHandler.LastProcessedRequest.Headers.GetValues("你要校验的头名称").FirstOrDefault());
}

方案优势 #

• 完全不需要依赖真实网络环境，不管本地/构建代理有没有开80端口，测试都能正常运行，你可以继续使用localhost作为测试URI
• 不会覆盖你要测试的DelegatingHandler逻辑，待测试的头部添加逻辑完全和生产环境执行流程一致，测试结果准确
• 改造成本极低，只需要新增十行左右的测试工具代码，原有测试流程几乎不需要调整
• 避免了单元测试变成集成测试，执行速度快、稳定性高，不会因为网络波动出现偶发失败

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