Apache SkyWalking 对 Spring WebFlux WebClient 6.x/HttpExchange 的支持解析

随着 Spring Boot 3.x 版本的发布，Spring 框架也升级到了 6.x 版本。在这个版本中，HttpExchange 成为了新一代的 HTTP 客户端实现方式。本文将深入分析 Apache SkyWalking 如何实现对 Spring WebFlux WebClient 6.x 和 HttpExchange 的支持，以及这对开发者意味着什么。

背景与现状

在 Spring Boot 3.x 中，HttpExchange 作为 org.springframework.boot.actuate.web.exchanges.HttpExchange 的一部分，提供了 GetExchange 和 PostExchange 等注解，成为开发者进行 HTTP 调用的新选择。然而，HttpExchange 底层依赖于 WebFlux 6.x 的 WebClient，这就带来了一个关键问题：如何在这种新的调用方式下保持请求的链路追踪连续性。

目前，当开发者使用 HttpExchange 进行请求时，SkyWalking 的追踪链路会出现中断，无法像传统方式那样完整记录整个调用过程。这给微服务架构下的问题排查和性能分析带来了挑战。

技术实现分析

要解决这个问题，需要从两个层面进行支持：

1. WebFlux 支持：作为异步框架，WebFlux 的调用逻辑可能被调度到不同线程执行，因此需要处理访问入口和访问出口两个部分。

2. WebClient 支持：HttpExchange 底层使用 WebClient 进行实际调用，需要确保在调用出口处能够正确传递上下文参数。

在技术实现上，SkyWalking 通过以下方式解决这个问题：

• 对于访问入口部分，已经通过相关代码合并实现了支持
• 对于访问出口部分，需要通过 WebClient 插件来实现，同时允许其他 API 通过工具包手动获取/设置上下文参数

实际效果

实现这一支持后，开发者可以：

1. 在 Spring Boot 3.x 项目中自由使用 GetExchange 或 PostExchange 进行 HTTP 调用
2. 保持完整的请求追踪链路，不再出现追踪中断的情况
3. 获得与传统调用方式相同的可观测性体验

追踪效果将如下图所示（描述追踪链路图），能够清晰展示从入口到出口的完整调用过程。

总结

Apache SkyWalking 对 Spring WebFlux WebClient 6.x 和 HttpExchange 的支持，是适应 Spring 生态演进的重要更新。这一改进使得采用最新 Spring 技术的项目能够继续享受 SkyWalking 提供的强大可观测能力，为微服务架构下的应用监控提供了无缝体验。

对于正在考虑或已经升级到 Spring Boot 3.x 的团队来说，这一支持意味着可以在享受新版本特性的同时，不必牺牲系统的可观测性。这也是 SkyWalking 持续跟进主流技术发展，为开发者提供最佳体验的体现。