如何为Yarp.ReverseProxy.Forwarder.HttpForwarder配置超时？

关键结论 #

HttpForwarder 支持超时配置，但核心的底层连接超时、连接池参数无法仅靠 appsettings.json 配置，必须在代码里显式自定义。

配置细节拆解 #

1. 配置文件能覆盖的基础超时 #

你可以在 appsettings.json 的 YARP 集群配置里添加基础转发超时，示例：

"ReverseProxy": {
  "Routes": {
    "demo-route": {
      "ClusterId": "demo-cluster",
      "Match": { "Path": "{**catch-all}" }
    }
  },
  "Clusters": {
    "demo-cluster": {
      "Destinations": {
        "demo-dest": { "Address": "http://your-upstream-api" }
      },
      "HttpRequest": { "Timeout": "00:00:10" } // 转发请求的整体超时
    }
  }
}

但这种配置只负责上层路由的整体请求超时，管不了 HttpForwarder 底层的连接复用、空闲连接回收这些细节——这就是你遇坑的原因：无延迟连续请求时，复用的连接刚好处于上游服务的关闭窗口期，直接被强制断开，触发502错误。

2. 必须代码显式配置的底层参数 #

要解决连接被强制关闭的问题，得在代码里显式配置 HttpForwarder 的底层 handler，调整连接池和超时逻辑，示例：

builder.Services.AddReverseProxy()
    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"))
    .ConfigureHttpForwarder((_, options) =>
    {
        // 设置转发请求的超时
        options.HttpClient.Timeout = TimeSpan.FromSeconds(10);
        // 自定义连接池和保活设置
        options.SocketsHttpHandler = new SocketsHttpHandler
        {
            PooledConnectionIdleTimeout = TimeSpan.FromSeconds(30),
            KeepAlivePingDelay = TimeSpan.FromSeconds(15),
            KeepAlivePingTimeout = TimeSpan.FromSeconds(5),
            EnableMultipleHttp2Connections = true
        };
    });

通过 ConfigureHttpForwarder 直接干预底层连接池逻辑，就能避免快速复用连接时被上游关闭的问题。

问题本质 #

你碰到的无延迟请求502，核心是连接复用时机冲突：第一个请求结束后，连接还没被上游完全释放，第二个请求立刻复用，导致上游强制断开连接。调整连接池空闲超时、启用保活机制，或者给请求添加重试逻辑，都能解决这个问题。

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