Spring Boot 3.x WebClient观测与指标自定义问题咨询

问题背景 #

我按照Spring Boot 3观测相关博客内容搭建了带观测功能的客户端和服务端应用，但遇到了WebClient的指标问题：

• 被监控的WebClient Bean生成的http_client指标中URI值为空或显示"None"
• 之前通过接收WebClient.Builder的自定义器添加http_client指标时，URI能正常显示，但改用ObservationWebClientCustomizer后该方式失效
• 自动注入ObservationWebClientCustomizer后，http_client指标直接消失；移除注入后指标恢复，但URI仍为空
• 该问题仅出现在WebClient Bean中，RestTemplate不受影响

疑问解答 #

1. Spring Boot 3是否像支持RestTemplate一样支持WebClient的观测功能？ #

是的，Spring Boot 3完全支持WebClient的观测功能，底层基于Micrometer Observation框架实现，和RestTemplate的观测能力对齐。两者都能自动生成http_client指标、追踪链路数据，只是WebClient作为非阻塞客户端，观测逻辑基于Reactor上下文传递观测信息。

2. 示例中选择RestTemplate而非WebClient的原因是什么？ #

官方示例选RestTemplate通常是因为它的同步调用模型更直观，代码示例更简洁，容易让开发者快速理解观测的核心逻辑。另外，RestTemplate的观测实现更贴近传统同步HTTP客户端的使用场景，适合作为入门示例。但这并不代表WebClient的观测支持不完善，只是示例侧重不同。

3. 如何使用WebClient和RestTemplate自定义器？它们的用途是什么？ #

WebClient自定义器

用途：统一配置应用中所有WebClient实例的观测、拦截器、编码器/解码器等通用逻辑，避免每个WebClient Bean重复配置。
使用方式：

• 实现WebClientCustomizer接口，重写customize(WebClient.Builder builder)方法，添加观测相关配置或自定义拦截器
• 或者直接使用Spring Boot自动配置的ObservationWebClientCustomizer，需确保正确集成：

@Bean
public WebClient webClient(WebClient.Builder builder, ObservationWebClientCustomizer observationCustomizer) {
    observationCustomizer.customize(builder);
    // 可添加其他自定义配置
    return builder.build();
}

注意：不要直接@Autowired注入ObservationWebClientCustomizer后不调用其customize方法，否则会覆盖Spring Boot的自动配置逻辑，导致指标消失。

RestTemplate自定义器

用途：统一配置所有RestTemplate实例的观测、消息转换器、拦截器等。
使用方式：

• 实现RestTemplateCustomizer接口，重写customize(RestTemplate restTemplate)方法
• 或者使用ObservationRestTemplateCustomizer，Spring Boot会自动将其应用到所有通过RestTemplateBuilder创建的RestTemplate实例

4. 要观测客户端的HTTP调用，是否必须在客户端应用中使用ObservationHandlers？ #

不需要。Spring Boot 3的自动配置已经默认注册了必要的ObservationHandler（比如用于生成指标的MetricsObservationHandler、用于追踪的TracingObservationHandler），只要引入了对应的starter（如spring-boot-starter-actuator、micrometer-tracing-bridge-brave等），就能自动启用观测功能。只有当你需要自定义观测行为（比如添加自定义标签、修改观测逻辑）时，才需要自定义ObservationHandler。

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