Spring Boot 3中RestTemplate与Micrometer连接池指标绑定兼容问题

方案一：使用Micrometer对HttpClient 5的原生支持（推荐） #

Spring Boot 3.x对应的Micrometer版本已提供HttpClient 5专属的指标绑定类，替换旧的PoolingHttpClientConnectionManagerMetricsBinder为HttpClient5ConnectionPoolMetricsBinder（包路径为io.micrometer.core.instrument.binder.httpcomponents.hc5）即可解决兼容问题。

示例代码：

import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.binder.httpcomponents.hc5.HttpClient5ConnectionPoolMetricsBinder;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HttpClientConfig {

    @Bean
    public PoolingHttpClientConnectionManager connectionManager() {
        return new PoolingHttpClientConnectionManager();
    }

    @Bean
    public HttpClient5ConnectionPoolMetricsBinder connectionPoolMetricsBinder(PoolingHttpClientConnectionManager connectionManager, MeterRegistry meterRegistry) {
        HttpClient5ConnectionPoolMetricsBinder binder = new HttpClient5ConnectionPoolMetricsBinder(connectionManager, "http-client-pool");
        binder.bindTo(meterRegistry);
        return binder;
    }
}

方案二：自定义指标绑定（原生支持失效时备用） #

若不想依赖Micrometer的hc5绑定类，可手动采集连接池核心指标并注册到MeterRegistry：

import io.micrometer.core.instrument.Gauge;
import io.micrometer.core.instrument.MeterRegistry;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class CustomHttpClientMetricsConfig {

    @Bean
    public PoolingHttpClientConnectionManager connectionManager() {
        return new PoolingHttpClientConnectionManager();
    }

    @Bean
    public void registerHttpClientMetrics(PoolingHttpClientConnectionManager connectionManager, MeterRegistry meterRegistry) {
        // 活跃连接数
        Gauge.builder("http.client.pool.active.connections", connectionManager, cm -> cm.getTotalStats().getActive())
                .tag("pool", "http-client")
                .register(meterRegistry);
        
        // 空闲连接数
        Gauge.builder("http.client.pool.idle.connections", connectionManager, cm -> cm.getTotalStats().getIdle())
                .tag("pool", "http-client")
                .register(meterRegistry);
        
        // 已使用连接数上限
        Gauge.builder("http.client.pool.max.connections", connectionManager, cm -> cm.getTotalStats().getMax())
                .tag("pool", "http-client")
                .register(meterRegistry);
    }
}

依赖与注意事项 #

• 确保依赖统一使用HttpClient 5版本，避免混合4.x与5.x包引发冲突：

<!-- Micrometer核心依赖 -->
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-core</artifactId>
</dependency>
<!-- HttpClient5依赖 -->
<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
</dependency>
<!-- Spring Boot Actuator自动引入Micrometer相关组件 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

• Spring Boot 3的HttpComponentsClientHttpRequestFactory已适配HttpClient5，直接传入org.apache.hc.client5.http.classic.HttpClient实例即可，无需回退旧包。

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