Spring自定义WebClient.Builder Bean避免循环引用及TraceParent填充问题

1. 如何注入Spring默认的WebClient.Builder避免循环引用 #

你遇到的循环引用问题，是因为Spring创建自定义customBuilder Bean时，会把它本身作为WebClient.Builder类型的候选注入到方法参数中，形成闭环。解决核心是明确指定注入Spring自动配置的默认Builder实例。

Spring Boot会自动注册一个名为webClientBuilder的默认WebClient.Builder Bean（只要你没有用自定义Bean覆盖它的默认注册）。只需在方法参数上通过@Qualifier指定这个默认Bean的名称，就能让Spring注入正确实例，避开循环引用：

@Bean("customBuilder")
public WebClient.Builder customBuilder(@Qualifier("webClientBuilder") WebClient.Builder defaultBuilder) {
    return defaultBuilder
            .headers(headers -> { /* 你的自定义请求头配置 */ })
            .filters(filters -> { /* 你的自定义过滤器配置 */ });
}

这种方式既保留了Spring默认Builder自带的Micrometer traceparent填充逻辑，又能基于它扩展自定义配置，同时满足其他应用基于该Builder创建WebClient的需求。

2. 手动填充traceparent的备选方案 #

如果最终选择不依赖默认Builder的自动填充逻辑，你可以直接使用Micrometer的Tracer类手动添加traceparent请求头：

1. 确保项目引入micrometer-tracing相关依赖
2. 在自定义WebClient过滤器中注入Tracer，从当前TraceContext中获取traceparent值并添加到请求头：

@Bean("customBuilder")
public WebClient.Builder customBuilder(Tracer tracer) {
    return WebClient.builder()
            .filters(filters -> {
                filters.add((request, next) -> {
                    TraceContext traceContext = tracer.currentTraceContext().context();
                    if (traceContext != null) {
                        ClientRequest modifiedRequest = ClientRequest.from(request)
                                .header("traceparent", TraceContextFormat.format(traceContext))
                                .build();
                        return next.exchange(modifiedRequest);
                    }
                    return next.exchange(request);
                });
            })
            // 其他自定义配置
            .headers(headers -> { /* ... */ });
}

这种方式完全自主控制traceparent的生成和注入，无需依赖Spring默认Builder的逻辑，但需确保Tracer Bean已被Spring正确初始化。

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