很多开发者看到 Spring Cloud Gateway 配置里有 spring.cloud.gateway.httpclient，就下意识认为：
“哦，这是在配 Apache HttpClient 吧？”
大错特错！
本文将彻底澄清 Gateway 的底层 HTTP 客户端真相，告诉你：
- 它到底用的是谁？
- 为什么不用 Apache HttpClient？
- 超时配置单位为何不一致？
- 如何正确调优？
❌ 常见误解：Gateway = Apache HttpClient？
在项目中，你可能写过这样的配置：
spring:
cloud:
gateway:
httpclient:
connect-timeout: 1000
response-timeout: 5s
于是很多人以为：
“这是在配置 Apache HttpClient 的连接池和超时。”
但事实是——Apache HttpClient 根本没参与 Gateway 的任何转发流程！
✅ 真相：Gateway 用的是 Reactor Netty HttpClient
Spring Cloud Gateway 基于 Spring WebFlux + Project Reactor + Netty 构建，是一个纯响应式（Reactive）、非阻塞的网关。
因此，它调用后端微服务时，使用的是：
reactor.netty.http.client.HttpClient—— 由reactor-netty提供的原生非阻塞 HTTP 客户端
📦 依赖关系
spring-cloud-gateway-server
└── spring-boot-starter-reactor-netty
└── reactor-netty-http
└── io.projectreactor.netty.ReactorNetty
你可以在 mvn dependency:tree 中验证：根本没有 org.apache.httpcomponents:httpclient（除非你自己加了）。
🔧 那么，httpclient 配置到底作用于谁？
spring.cloud.gateway.httpclient 下的所有配置，最终都会作用于：
HttpClient.create()
.tcpConfiguration(tcp ->
tcp.option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 1000)
)
.responseTimeout(Duration.ofSeconds(5));
也就是说：
connect-timeout→ 设置 TCP 连接超时（单位：毫秒，int 类型）response-timeout→ 设置整个请求-响应超时（单位：Duration，支持 "5s"、"5000ms"）
💡 这也是为什么两个 timeout 的单位写法不同！
❓ 为什么不用 Apache HttpClient 或 OkHttp？
| 客户端 | 是否阻塞 | 是否支持 Reactive | 能否用于 Gateway |
|---|---|---|---|
| Apache HttpClient | ✅ 阻塞 | ❌ 不支持 | ❌ 不能 |
| OkHttp | ✅ 阻塞（虽有异步回调，但非 Reactive） | ❌ | ❌ 不能 |
| Reactor Netty HttpClient | ❌ 非阻塞 | ✅ 原生支持 Flux/Mono | ✅ 唯一选择 |
Gateway 的整个处理链是 响应式流（Reactive Stream），必须使用能融入 Publisher/Subscriber 模型的客户端。
而 Apache HttpClient 是“发起请求 → 等待返回”的阻塞模型，会直接卡死 Netty 的 EventLoop 线程！
⚠️ 如果强行引入 Apache HttpClient 会怎样？
即使你在 pom.xml 里加了：
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
</dependency>
Gateway 依然不会用它！
这个依赖只会影响你项目中自己写的 RestTemplate 或 Feign（如果你配置了），但对 Gateway 转发流量毫无影响。
✅ 正确调优建议
1. 必须配置超时！
默认 response-timeout 是 无限等待，后端一慢，网关就堆积请求 → OOM！
spring:
cloud:
gateway:
httpclient:
connect-timeout: 1000 # 1秒连接超时
response-time timeout: 3s # 3秒响应超时
2. 不要试图替换 HTTP 客户端
除非你重写 NettyRoutingFilter，否则无法更换底层客户端。
3. 监控 Netty 指标
可通过 Micrometer 暴露 Netty 连接池、延迟等指标，用于 SRE 监控。
🧪 验证方法：看日志线程名
发起一个请求，观察日志：
[ctor-http-nio-3] ... Forwarding request to http://user-service...
ctor-http-nio-*是 Netty 的 EventLoop 线程- 如果用了 Apache HttpClient，你会看到
http-nio-*（Tomcat 线程）或pool-*（线程池线程）
这进一步证明：全程由 Netty 处理，无第三方客户端介入。
✅ 总结
| 问题 | 答案 |
|---|---|
| Gateway 用 Apache HttpClient 吗？ | ❌ 完全不用 |
| 默认 HTTP 客户端是什么？ | ✅ Reactor Netty HttpClient |
connect-timeout 单位是？ | ✅ 毫秒（整数） |
response-timeout 单位是？ | ✅ Duration（如 "5s"） |
| 能换成 OkHttp 吗？ | ❌ 架构不兼容，不支持 |
记住：Gateway 是响应式高速公路，只认 Netty 这一辆车。其他“车”（HttpClient/OkHttp）根本开不进来！
✅ 如果你正在调优 Gateway 性能，务必理解其底层客户端机制！ ✅ 欢迎点赞收藏，关注我获取更多 Spring Cloud 深度解析！
