Spring WebClient因连接闲置引发请求延迟问题求助

一、问题根源分析 #

从日志和你的配置来看，核心问题分为两点：

1. 首次请求慢：连接池尚未初始化连接，需要完成HTTPS握手（这是13-15秒耗时的主要原因）。
2. 闲置后请求慢：外部API服务器/中间网络设备（负载均衡、防火墙）主动关闭了闲置连接，你调整客户端maxIdleTime/maxLifeTime无效，因为连接关闭的发起方不在客户端。

二、规范的连接预热方案 #

使用Spring的ApplicationRunner在应用启动完成后自动发起预热请求，确保连接池提前建立好可用连接（尤其是HTTPS连接，避免首次握手耗时）。

代码实现 #

@Component
public class WebClientWarmupRunner implements ApplicationRunner {

    private static final Logger log = LoggerFactory.getLogger(WebClientWarmupRunner.class);
    private final WebClient webClient;

    public WebClientWarmupRunner(WebClient webClient) {
        this.webClient = webClient;
    }

    @Override
    public void run(ApplicationArguments args) {
        // 优先调用外部API的轻量健康检查接口，无则调用业务中最常用的简单GET接口
        webClient.get()
                .uri("/api/ping")
                .retrieve()
                .toBodilessEntity()
                .doOnSuccess(response -> log.info("WebClient预热完成，连接已建立"))
                .doOnError(error -> log.warn("WebClient预热失败: {}", error.getMessage()))
                .block(); // 同步等待预热完成，避免应用启动完成但连接未就绪

        // 如需预热多个连接（比如匹配连接池大小），可并发发起请求（控制并发数避免干扰外部API）
        // IntStream.range(0, 5)
        //         .mapToObj(i -> webClient.get().uri("/api/ping").retrieve().toBodilessEntity())
        //         .collect(Collectors.toList())
        //         .forEach(Mono::block);
    }
}

注意事项 #

• 优先选择外部API的轻量接口（如/ping、/health），避免对业务接口造成不必要的压力。
• 若外部无此类接口，可调用业务中最常用的简单GET接口，仅验证连接建立即可，无需处理完整响应。

三、解决闲置后连接失效问题 #

需要从「连接有效性验证」和「减少重连耗时」两方面入手：

1. 配置连接池的连接有效性校验 #

在获取连接时主动验证连接是否可用，避免拿到已被服务端关闭的无效连接：

修改ConnectionProvider配置，添加onAcquire钩子：

@Bean
public ConnectionProvider connectionProvider() {
    return ConnectionProvider.builder("MyApplicationConnection")
            .maxConnections(100)
            .pendingAcquireTimeout(Duration.ofSeconds(60))
            .maxIdleTime(Duration.ofMinutes(1)) // 设为比外部服务闲置超时短（比如外部1分钟断连，此处设1分钟）
            .maxLifeTime(Duration.ofMinutes(60))
            .evictInBackground(Duration.ofMinutes(1)) // 缩短后台清理周期，及时回收无效连接
            .onAcquire((connection, stats) -> {
                // 发送空字节包测试连接，若失败则自动关闭，连接池会创建新连接
                return connection.channel()
                        .writeAndFlush(new EmptyByteBuf(connection.channel().alloc()))
                        .addListener(ChannelFutureListener.CLOSE_ON_FAILURE);
            })
            .build();
}

2. 启用SSL会话复用，减少重连耗时 #

HTTPS握手是耗时大户，启用SSL会话缓存可大幅缩短重连时的握手时间：

修改HttpClient配置：

@Bean
public HttpClient httpClient(ConnectionProvider connectionProvider) {
    return HttpClient.create(connectionProvider)
            .secure(sslSpec -> sslSpec
                    .sslContext(SslContextBuilder.forClient().build())
                    .sessionCacheSize(1000) // 缓存SSL会话数量
                    .sessionTimeout(Duration.ofMinutes(30))) // 会话超时时间
            .doOnConnected(connection ->
                    connection.addHandlerLast(new ReadTimeoutHandler(10))
                              .addHandlerLast(new WriteTimeoutHandler(10)))
            .wiretap("reactor.netty.http.client.HttpClient", LogLevel.DEBUG, AdvancedByteBufFormat.TEXTUAL);
}

3. 移除冗余的Keep-Alive配置 #

Reactor Netty的HttpClient默认已启用HTTP长连接，手动设置Connection: keep-alive可能与JBoss的出站代理配置冲突，建议移除：

// 移除该行配置
.defaultHeader(HttpHeaders.CONNECTION, "keep-alive")

4. 检查JBoss EAP的出站连接配置 #

JBoss EAP可能存在出站连接的闲置超时设置，需确认以下内容：

• 检查standalone.xml/domain.xml中undertow subsystem的server配置，是否有connection-timeout或idle-timeout影响出站连接。
• 若使用JBoss的代理功能，需确认代理的连接闲置超时设置，避免代理主动关闭连接。

四、验证效果 #

1. 应用启动后，查看日志确认预热请求成功，首次业务请求耗时应大幅降低。
2. 闲置1-2分钟后发起请求，通过日志确认连接池会自动验证并创建新连接（或复用有效连接），耗时不再出现13-15秒的情况。

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