Spring Cloud Gateway出现PoolAcquireTimeoutException请求超时问题求助

问题根源 #

这个异常本质是Reactor Netty连接池在45秒内无法获取到可用连接，核心原因是连接池资源被耗尽，没有空闲连接分配给新请求。

原因分析&解决办法 #

1. 扩容连接池核心配置 #

默认连接池参数通常无法满足高并发场景，直接调整配置参数：
在application.yml中添加：

spring:
  cloud:
    gateway:
      httpclient:
        pool:
          max-active: 200  # 最大活跃连接数，根据业务并发量上调，默认值偏低
          max-pending-acquires: 500  # 允许排队等待连接的最大请求数，避免直接拒绝请求
          acquire-timeout: 60000  # 将获取连接超时从45秒延长至60秒，给请求更多等待窗口
          max-idle-time: 300000  # 空闲连接5分钟未使用则回收，避免资源闲置

若需给特定路由单独配置连接池，可自定义HttpClient：

@Configuration
public class GatewayPoolConfig {
    @Bean
    public HttpClient gatewayHttpClient() {
        return HttpClient.create()
                .tcpConfiguration(tcpClient -> tcpClient
                        .connectionPool(pool -> pool
                                .maxConnections(200)
                                .pendingAcquireTimeout(Duration.ofSeconds(60))
                                .pendingAcquireMaxCount(500)));
    }
}

2. 排查连接泄漏问题 #

连接未正常释放会持续占用池资源，需重点检查：

• 后端服务异常（超时、报错）时连接未关闭
• 自定义过滤器中WebClient等请求工具未处理异常，导致连接卡住
  开启连接池日志监控，定位泄漏点：

logging:
  level:
    reactor.netty.resources: DEBUG
    reactor.netty.http.client: DEBUG

通过日志分析连接的创建、释放记录，找出未归还的连接来源。

3. 优化后端服务响应速度 #

后端接口处理过慢会长期占用连接，导致池资源耗尽：

• 排查后端性能瓶颈（慢SQL、第三方接口超时等）
• 在Gateway路由中添加超时限制，避免连接被长期占用：

spring:
  cloud:
    gateway:
      routes:
        - id: your_service_route
          uri: lb://your-service
          predicates:
            - Path=/your-api/**
          filters:
            - name: Timeout
              args:
                response-timeout: 10000  # 10秒未响应则断开连接，释放资源

4. 调整I/O线程池大小 #

Reactor Netty处理连接的线程不足，会导致连接处理效率低下：

spring:
  cloud:
    gateway:
      httpclient:
        worker-count: 4  # 建议设置为CPU核心数的2倍，根据服务器配置调整

应急处理 #

若服务已出现异常，可临时重启Gateway释放连接池资源，但这仅为临时方案，需从上述根本原因入手解决。

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