如何通过编程方式设置Quarkus REST Client的连接池大小？

当使用QuarkusRestClientBuilder编程式构建REST客户端时，无法直接通过注解式的quarkus.rest-client.connection-pool-size属性配置连接池，但可以通过配置底层HTTP客户端实现（Vert.x或Apache HttpClient）来设置连接池参数，以下是两种主流实现的配置方式：

1. 基于Vert.x的默认实现 #

Quarkus REST Client默认使用Vert.x HTTP客户端，可通过VertxHttpClientOptions包装Vertx原生配置来设置连接池：

import io.quarkus.rest.client.runtime.vertx.VertxHttpClientOptions;
import io.vertx.core.http.HttpClientOptions;
import java.net.URI;

// 配置Vertx HTTP客户端连接池参数
HttpClientOptions vertxOpts = new HttpClientOptions()
        .setMaxPoolSize(20) // 对应注解式的connection-pool-size，设置连接池最大连接数
        .setKeepAlive(true) // 开启长连接，提升连接池复用效率
        .setIdleTimeout(30); // 空闲连接超时时间（秒），超时后自动回收

SomeRestClient client = QuarkusRestClientBuilder.newBuilder()
        .baseUri(new URI(baseUrl))
        .proxyAddress("some-proxy-address", 80)
        .withConfigKey("quarkus.rest-client.vertx.options", new VertxHttpClientOptions(vertxOpts))
        .build(SomeRestClient.class);

2. 基于Apache HttpClient实现 #

若项目引入了quarkus-rest-client-apache依赖，可通过ApacheHttpClientOptions配置Apache连接池：

import io.quarkus.rest.client.apache.ApacheHttpClientOptions;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import java.net.URI;

// 创建连接池管理器并配置参数
PoolingHttpClientConnectionManager connManager = new PoolingHttpClientConnectionManager();
connManager.setMaxTotal(20); // 总连接池大小
connManager.setDefaultMaxPerRoute(10); // 每个目标路由的最大连接数
connManager.setValidateAfterInactivity(5); // 空闲连接验证间隔（秒）

// 构建Apache HttpClient配置
HttpClientBuilder clientBuilder = HttpClientBuilder.create().setConnectionManager(connManager);

SomeRestClient client = QuarkusRestClientBuilder.newBuilder()
        .baseUri(new URI(baseUrl))
        .proxyAddress("some-proxy-address", 80)
        .withConfigKey("quarkus.rest-client.apache.options", ApacheHttpClientOptions.fromHttpClientBuilder(clientBuilder))
        .build(SomeRestClient.class);

注意事项 #

• 若使用Apache HttpClient实现，需确保项目中添加了quarkus-rest-client-apache依赖；
• 除了连接池大小，还可通过对应配置类设置超时、连接回收等参数，适配不同业务场景。

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