Vertx WebClient闲置后需重连问题咨询（含配置代码）

问题现象 #

配置了长连接的WebClient，在连接闲置一段时间后无法复用，必须重新建立连接，监控指标vertx.http.clients.open-netsockets会快速降到0。

当前配置代码 #

val options =
    WebClientOptions().setMaxPoolSize(1000)
        .setKeepAlive(true)
        .setKeepAliveTimeout(60 * 10)
        .setTrustAll(true)
        .setPoolCleanerPeriod(1000 * 60 * 10)
        .setIdleTimeoutUnit(TimeUnit.MINUTES)
        .setIdleTimeout(10)
        .setMaxWaitQueueSize(1000)
        .setConnectTimeout(1000 * 60 * 10)

webClient = WebClient.create(vertx, options)

问题分析 #

1. IdleTimeout与KeepAliveTimeout设置冲突：你把idleTimeout和keepAliveTimeout都设为10分钟，Vert.x的idleTimeout会主动关闭闲置达到该时长的连接——哪怕开启了KeepAlive。这意味着连接刚达到KeepAlive超时阈值，就会被客户端主动清理，根本留不到连接池里复用。
2. 连接池清理周期加速连接回收：poolCleanerPeriod设为10分钟，会定期扫描并清理闲置超过idleTimeout的连接，进一步加快连接被回收的速度。
3. 服务器端配置可能拖后腿：如果服务器端的KeepAlive超时（比如Nginx的keepalive_timeout、Tomcat的connectionTimeout）比客户端短，服务器会先主动断开连接，客户端连接池里的闲置连接也会随之失效被清理。

解决方案 #

1. 调整IdleTimeout大于KeepAliveTimeout #

把idleTimeout设为比keepAliveTimeout更长的时间，让客户端不会在KeepAlive周期内主动关闭连接：

val options =
    WebClientOptions().setMaxPoolSize(1000)
        .setKeepAlive(true)
        .setKeepAliveTimeout(60 * 10) // 保持10分钟的HTTP长连接超时
        .setTrustAll(true)
        .setPoolCleanerPeriod(1000 * 60 * 10)
        .setIdleTimeoutUnit(TimeUnit.MINUTES)
        .setIdleTimeout(15) // 设为15分钟，长于KeepAlive超时
        .setMaxWaitQueueSize(1000)
        .setConnectTimeout(1000 * 60 * 10)

webClient = WebClient.create(vertx, options)

2. 同步服务器端KeepAlive配置 #

确认服务器端的KeepAlive超时设置不短于客户端的keepAliveTimeout，避免服务器先一步断开连接，导致客户端连接池里的连接失效。

3. 开启日志排查连接关闭原因 #

添加Vert.x HTTP客户端的Debug日志，精准定位连接关闭的触发原因：

logging.level.io.vertx.core.http=DEBUG

通过日志可以区分连接是客户端因IdleTimeout主动关闭，还是服务器端主动断开。

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