当前位置：首页 > news >正文

一文读懂WebClient和RestTemplate的差异

news 2025/9/6 1:58:20

自 Spring 5 以来，WebClient已成为Spring WebFlux的一部分，并且是发出 HTTP 请求的首选方式。它是经典RestTemplate的首选替代方案，后者自 Spring 5.0 以来一直处于维护模式。

本文将讨论 Spring WebClient和RestTemplate类之间的主要区别。

1. WebClient和RestTemplate快速比较

特征	WebClient	RestTemplate
反应式编程	基于反应式原则构建并支持反应式编程。	同步而不是为反应式编程而设计。
技术	构建在反应式技术栈上。	构建在 Servlet 技术栈上。
线程模型	采用非阻塞I/O，适合处理大量并发请求。	使用阻塞 I/O，在高并发场景下可能会导致线程阻塞。
Java版本	需要 Java 8+ 或更高版本。支持函数式编程。	与 Java 6+ 或更高版本兼容。
错误处理	使用onErrorResume、onErrorReturn等运算符提供强大的错误处理。	错误处理通常使用 try-catch 块完成。
流媒体	支持使用Flux和Mono流式传输数据，适合反应式流式场景。	对流的支持有限，不太适合反应式流。
用例	最适合微服务、反应式应用以及需要高并发的场景。	适用于传统的整体应用程序和简单的用例。
依赖关系	需要Spring WebFlux依赖项。	需要Spring Web依赖。
未来的支持	与反应式编程模型保持一致，并可能会得到持续的开发和支持。	可能会维护更新，将来可能不会受到那么多关注。

2. 阻塞RestTemplate与非阻塞WebClient对比

2.1.RestTemplate

RestTemplate本质上是阻塞的，并使用 Java Servlet API 的每个请求一个线程模型。这意味着RestTemplate一旦向远程服务器发送请求，就会等待响应。默认情况下，每次RestTemplate都会创建新的，并在收到并处理响应后关闭连接。Httpconnection 创建和关闭 URL 连接是一项成本高昂的操作。为了在生产类应用程序中有效地使用RestTemplate ，我们必须使用HTTP 连接池，否则性能会快速下降。当应用程序中有大量请求时，线程和连接的数量也会按比例增加。这会给服务器资源带来负担。如果服务器速度缓慢，用户很快就会发现应用程序性能下降，甚至无响应。

请注意，RestTemplate 是线程安全的，并且可以随时在多个连接之间共享单个实例。

@Service
public class MyService {private final RestTemplate restTemplate;@Autowiredpublic MyService(RestTemplate restTemplate) {this.restTemplate = restTemplate;}public String getData() {ResponseEntity<String> responseEntity= restTemplate.getForEntity("https://api.example.com/data", String.class);String responseBody = responseEntity.getBody();return responseBody;}
}

2.2.WebClient

与RestTemplate相反，WebClient本质上是异步且非阻塞的。它遵循 Spring WebFlux 反应式框架的事件驱动架构。使用WebClient，客户端无需等待响应返回。相反，当服务器有响应时，它将使用回调方法收到通知。

当我们通过WebClient调用返回 Mono或 Flux 的API 时，API 会立即返回。而调用结果将通过 mono 或 flux 回调传递给调用端。

请注意，如果需要，我们可以通过WebClient.block()方法实现类似RestTemplate的同步处理。

@Service
public class MyService {private final WebClient webClient;@Autowiredpublic MyService(WebClient webClient) {this.webClient = webClient;}public Mono<String> getData() {return webClient.get().uri("/data").retrieve().bodyToMono(String.class).subscribe(// onSuccess callbackresult -> {System.out.println("Success: " + result);},// onError callbackerror -> {System.err.println("Error: " + error.getMessage());});}
}