SpringBoot中RestClient、WebClient和RestTemplate比较选择
内容提要
本文比较了在Spring Boot应用程序中调用REST API的RestClient、WebClient和RestTemplate库，并提供了正确选择的建议。RestTemplate是Spring框架中成熟的同步HTTP客户端库，但缺乏一些竞争对手的功能。WebClient是为非阻塞环境设计的现代化异步HTTP客户端库。RestClient是Spring Framework 6.1中引入的，具有与RestTemplate相似的基础架构和流畅API。根据不同的需求和环境，选择合适的库来调用REST API。
延伸解读
RestClient：Spring MVC 的现代同步客户端
RestClient 在 Spring Framework 6.1 中引入，拥有与 RestTemplate 相同的基础架构（阻塞式），但提供了类似 WebClient 的流畅 API。它不需要引入 WebFlux 依赖，也不需调用 block() 方法，因此非常适合 Spring MVC 项目。对于新项目，Spring 团队推荐使用 RestClient；对于现有项目，从 RestTemplate 迁移到 RestClient 也是值得考虑的选择，因为 RestTemplate 已处于维护模式。
WebClient 在阻塞栈中的取舍
WebClient 是为 WebFlux 设计的异步非阻塞客户端，但在 Web MVC 中可通过 block() 方法使用。这样做虽然能获得 WebClient 的流畅 API 和底层非阻塞能力，但会阻塞调用线程，并且需要添加 WebFlux 和 Project Reactor 依赖。因此，在纯 MVC 项目中，除非需要流式支持或已计划迁移到 WebFlux，否则 RestClient 是更简洁的选择。
声明式 HTTP 接口：三者皆支持
RestTemplate、WebClient 和 RestClient 都支持使用 @HttpExchange 注解将 HTTP 服务定义为 Java 接口，并通过代理工厂创建客户端。这有助于减少样板代码，提高可维护性。不同之处在于创建代理时需分别使用 RestTemplateAdapter、WebClientAdapter 和 RestClientAdapter。开发者可以根据项目使用的客户端库灵活选择。
可观察性：微服务调用的关键
HTTP 客户端在微服务间传播可观察性上下文，因此确保代码可追踪和分析至关重要。良好的可观察性有助于理解执行路径、检测超时和性能问题。文章提到使用 Digma 等工具可以在开发阶段观察 HTTP 客户端活动。无论选择哪个客户端，都应考虑集成可观察性机制，以便于调试和运维。
Q&A
Spring Boot 中 RestClient、WebClient 和 RestTemplate 的主要区别是什么？
主要区别在于编程范式和 API 设计。RestTemplate 是同步阻塞的，基于模板方法模式；WebClient 是为 WebFlux 设计的异步非阻塞客户端，具有流畅 API；RestClient 是 Spring 6.1 引入的同步阻塞客户端，但拥有类似 WebClient 的流畅 API，且不需要 WebFlux 依赖。
在 Spring MVC 项目中，我应该选择 RestClient 还是 WebClient？
对于新的 Spring MVC 项目，推荐使用 RestClient，因为它提供了现代流畅的 API，且不需要引入 WebFlux 依赖。如果项目已经使用了 WebClient 但属于阻塞栈，可以考虑迁移到 RestClient，因为迁移成本不高且能避免额外依赖。
RestTemplate 有哪些优缺点？
优点：可切换底层 HTTP 客户端库、支持声明式 HTTP 接口、高度可配置、可用于旧版本 Spring。缺点：方法重载多导致使用困难、模板模式过时、不适合非阻塞环境。
WebClient 在 Spring MVC 中如何使用？有什么注意事项？
在 Spring MVC 中可以使用 WebClient，但需要调用 block() 方法将异步结果转为同步，这会阻塞当前线程。虽然技术上可行，但需要添加 WebFlux 和 Reactor 依赖，增加了项目复杂度。
如何从 RestTemplate 迁移到 RestClient？
Spring Framework 团队提供了迁移指南。迁移时，可以用 RestClient.builder() 创建 RestClient 实例，其 API 与 WebClient 类似，但不需要 WebFlux 依赖。对于声明式接口，使用 RestClientAdapter 和 HttpServiceProxyFactory 创建代理。
什么是 HTTP 客户端可观察性？为什么它很重要？
可观察性是指跟踪和分析代码执行路径的能力。对于 HTTP 客户端尤为重要，因为它们在微服务间传播上下文。良好的可观察性可以提高开发效率、帮助检测超时和性能问题。可以使用如 Digma 等工具在开发中实现可观察性。
