Spring WebClient maxLifeTime配置疑问：活跃连接会被关闭吗？

环境与配置 #

配置文件（YAML） #

http-connection-config: 
  max-idle-time-seconds: 25
  max-life-time-seconds: 60
  evict-in-background-seconds: 120

代码实现 #

ConnectionProvider provider = ConnectionProvider.builder("fixed")
                .maxIdleTime(Duration.ofSeconds(connectionProviderConfig.getMaxIdleTimeSeconds()))
                .maxLifeTime(Duration.ofSeconds(connectionProviderConfig.getMaxLifeTimeSeconds()))
                .evictInBackground(Duration.ofSeconds(connectionProviderConfig.getEvictInBackgroundSeconds())).build();
builder = builder.clientConnector(new ReactorClientHttpConnector(HttpClient.create(provider)));

遇到的问题 #

出现间歇性PrematureCloseException，且流量增加时更频繁：

Caused by: reactor.netty.http.client.PrematureCloseException: Connection prematurely closed BEFORE response
Suppressed: org.springframework.web.reactive.function.client.WebClientRequestException: Connection prematurely closed BEFORE response
Caused by: java.util.concurrent.CompletionException: RestCallFailedException(super=com.tmobile.genesis.common.integration.framework.exception.RestCallFailedException, code=SILCC0015, userMessage=Error on System API call out, systemMessage=Connection prematurely closed BEFORE response, detailLink=)

服务器端超时设置为10秒，但报错时请求仅执行了5-9秒，说明是客户端主动关闭了连接。

核心疑问 #

maxLifeTime会导致正在处理活跃请求的连接被关闭吗？比如连接已建立55秒，此时被用于API调用，会在60秒时强制关闭连接，哪怕请求还在处理中？

解答 #

Reactor Netty的maxLifeTime不会主动关闭正在处理活跃请求的连接。它的作用是限制连接的总存活时长，但仅针对空闲状态的连接触发清理逻辑：

• 当连接处于活跃状态（正在处理请求、传输数据）时，生命周期计时会暂停，直到请求完成、连接回到空闲状态后，才会继续计算剩余存活时间。
• 若连接在空闲期间达到maxLifeTime阈值，会被连接池清理；但如果连接正在处理请求，哪怕已超过maxLifeTime的时长，也会等请求完成后再处理。

问题根源推测 #

你遇到的PrematureCloseException，更可能是以下原因导致：

• evictInBackground设置为120秒，清理周期过长，导致大量已失效的空闲连接堆积在池中。流量突增时，连接池复用这些已被服务器端关闭的连接，发起请求时发现连接已断开，从而抛出异常。
• 客户端maxIdleTime（25秒）与服务器端的连接空闲超时不匹配，服务器端可能在客户端清理空闲连接前就主动关闭了连接，客户端复用这类连接时触发报错。

调整建议 #

• 缩短evictInBackground周期，比如设置为30秒，让连接池更及时地清理失效连接。
• 增加连接池maxConnections配置（当前代码未设置），提升连接池容量以应对流量突增。
• 确保客户端maxIdleTime略短于服务器端的连接空闲超时，避免服务器先关闭连接引发客户端报错。

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