Spring Boot(Spring3) GraphQL微服务链路追踪问题求助

你的问题核心是HttpGraphQlClient默认不会自动注入微追踪头，它依赖底层的WebClient来完成追踪上下文的传播。要解决traceId不传播的问题，需要给WebClient添加Micrometer Tracing提供的过滤器，再用这个WebClient构建HttpGraphQlClient。

具体步骤 #

1. 确保依赖完整 #

除了你已有的micrometer依赖，确认项目中包含spring-boot-starter-webflux（WebClient属于WebFlux模块），如果没有，添加依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

2. 配置带追踪过滤器的WebClient #

创建带有TracingExchangeFilterFunction的WebClient Bean，这个过滤器会自动将当前上下文的traceId、spanId等追踪信息注入请求头：

@Bean
public WebClient tracingWebClient(ClientHttpConnector clientHttpConnector,
                                  TracingExchangeFilterFunction tracingExchangeFilterFunction) {
    return WebClient.builder()
            .clientConnector(clientHttpConnector)
            .filter(tracingExchangeFilterFunction)
            .defaultHeader(HttpHeaders.CONTENT_TYPE, "application/json")
            .defaultHeader(HttpHeaders.ACCEPT, "application/json")
            .build();
}

3. 基于配置好的WebClient构建HttpGraphQlClient #

修改你的HttpGraphQlClient Bean，使用上面的WebClient来构建：

@Bean
public HttpGraphQlClient dataServiceHttpGraphQlClient(@Value("${url}") String dataServiceUrl,
                                                      WebClient tracingWebClient) {
    return HttpGraphQlClient.builder(tracingWebClient)
            .url(dataServiceUrl)
            .build();
}

原理说明 #

TracingExchangeFilterFunction是Micrometer Tracing提供的WebClient过滤器，它会从当前的观测上下文（ObservationContext）中获取traceId和spanId，按照Brave的格式（比如X-B3-TraceId、X-B3-SpanId）注入到请求头中，目标服务就能接收到追踪信息，完成traceId的跨服务传播。

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