在 Spring Boot 3.2 之后，開發(fā)者迎來了一個(gè)新的 HTTP 客戶端選擇——RestClient。過去我們有兩種主要方式：

• RestTemplate —— 經(jīng)典但已進(jìn)入維護(hù)階段，不再推薦用于新項(xiàng)目；
• WebClient —— 響應(yīng)式優(yōu)先，功能強(qiáng)大，但對(duì)習(xí)慣命令式風(fēng)格的開發(fā)者來說門檻略高。

RestClient 的出現(xiàn)，正好彌合了兩者之間的空缺。它保留了 RestTemplate 的簡(jiǎn)潔語法，同時(shí)借助 WebClient 的底層能力，提供線程安全、可擴(kuò)展、支持插件化的同步 HTTP 調(diào)用方式。

接下來，我們將從內(nèi)部架構(gòu)、核心設(shè)計(jì)理念到具體實(shí)現(xiàn)流程，逐步解析 RestClient 內(nèi)部是如何運(yùn)作的。

為什么選擇 RestClient？

Spring 框架一直在演進(jìn)，以支持現(xiàn)代化的編程范式。隨著微服務(wù)和高并發(fā)場(chǎng)景的興起：

• RestTemplate 已顯得過時(shí)，無法滿足新的擴(kuò)展需求；
• WebClient 功能豐富，但對(duì)于只需同步調(diào)用的開發(fā)者來說稍顯“重量級(jí)”。

而 RestClient 則兼具二者優(yōu)勢(shì)：

• 保持調(diào)用鏈簡(jiǎn)潔，符合命令式風(fēng)格；
• 依托 WebClient，擁有強(qiáng)大的底層能力；
• 默認(rèn)線程安全，支持可插拔的攔截器和過濾器。

一句話：它是一個(gè)優(yōu)雅且現(xiàn)代的同步 HTTP 客戶端。

核心設(shè)計(jì)理念

RestClient 的設(shè)計(jì)遵循以下關(guān)鍵原則：

鏈?zhǔn)綐?gòu)建 API：通過 Builder 模式輕松構(gòu)建請(qǐng)求；

請(qǐng)求與執(zhí)行分離：更清晰的調(diào)用邏輯；

WebClient 驅(qū)動(dòng)：底層全權(quán)交由 WebClient 執(zhí)行；

可插拔過濾器：支持重試、超時(shí)、日志、限流等擴(kuò)展；

默認(rèn)線程安全：在高并發(fā)下依然穩(wěn)定可靠。

內(nèi)部工作機(jī)制

雖然 RestClient 給人一種輕量包裝的印象，但其內(nèi)部機(jī)制遠(yuǎn)比表面復(fù)雜。其調(diào)用鏈大致如下：

1. RestClient：開發(fā)者的入口點(diǎn)，用于構(gòu)建請(qǐng)求。
2. WebClient：負(fù)責(zé)真正的 HTTP 請(qǐng)求執(zhí)行。
3. ClientHttpConnector：WebClient 與底層 HTTP 引擎之間的橋梁。
4. Reactor Netty HttpClient：底層高性能 HTTP 引擎，負(fù)責(zé)網(wǎng)絡(luò)通信。

請(qǐng)求流轉(zhuǎn)路徑（簡(jiǎn)化版）

RestClient → WebClient → ClientHttpConnector → Reactor Netty HttpClient → 網(wǎng)絡(luò)請(qǐng)求

響應(yīng)會(huì)沿著同樣路徑返回，期間可附加攔截器或過濾器。

核心組件拆解

RestClient（入口 API）

開發(fā)者通過 RestClient 發(fā)起請(qǐng)求，示例：

package com.icoderoad.httpclient;


import org.springframework.web.client.RestClient;


public class Demo {
    public static void main(String[] args) {
        RestClient restClient = RestClient.create();
        String response = restClient.get()
            .uri("https://api.example.com/data")
            .retrieve()
            .body(String.class);
        System.out.println(response);
    }
}

這里的 API 設(shè)計(jì)延續(xù)了 RestTemplate 的風(fēng)格，但底層卻完全不同。

WebClient（執(zhí)行核心）

內(nèi)部真正執(zhí)行請(qǐng)求的核心組件，提供：

• 響應(yīng)式引擎支持；
• 編解碼器處理；
• 超時(shí)與攔截器機(jī)制；
• 過濾器鏈。

ClientHttpConnector（連接層）

負(fù)責(zé)連接 WebClient 與底層 HTTP 引擎，常見實(shí)現(xiàn)是 ReactorClientHttpConnector。

Reactor Netty HttpClient（底層引擎）

功能包括：

• 連接池管理；
• DNS 解析；
• SSL/TLS；
• 代理支持；
• TCP 級(jí)別超時(shí)控制。

進(jìn)階能力展示

請(qǐng)求重試機(jī)制

通過 ExchangeFilterFunctions 插件化配置：

RestClient client = RestClient.builder()
    .requestFactory(factory -> factory
        .filter(ExchangeFilterFunctions.retry(3)))
    .build();

超時(shí)控制

在底層 HttpClient 層設(shè)置：

HttpClient httpClient = HttpClient.create()
    .responseTimeout(Duration.ofSeconds(5));


ClientHttpConnector connector = new ReactorClientHttpConnector(httpClient);


RestClient client = RestClient.builder()
    .requestFactory(WebClientAdapter.forClient(WebClient.builder()
        .clientConnector(connector)
        .build()))
    .build();

代理配置

同樣通過底層 HttpClient 控制：

HttpClient httpClient = HttpClient.create()
    .proxy(proxy -> proxy
        .type(ProxyProvider.Proxy.HTTP)
        .host("localhost")
        .port(8888));

架構(gòu)圖示

圖片

總結(jié)與啟示

RestClient 代表了 Spring Boot 3.x 中同步 HTTP 調(diào)用的推薦方式：

• 它繼承了 RestTemplate 的簡(jiǎn)潔；
• 吸收了 WebClient 的強(qiáng)大；
• 在架構(gòu)上保持清晰的分層與擴(kuò)展性。

對(duì)于開發(fā)者而言，RestClient 讓同步 HTTP 調(diào)用更加自然高效，同時(shí)還能在需要時(shí)無縫利用響應(yīng)式特性。

結(jié)論

在分布式與微服務(wù)架構(gòu)盛行的今天，選擇一個(gè)合適的 HTTP 客戶端至關(guān)重要。RestClient 的出現(xiàn)，不僅解決了命令式調(diào)用的痛點(diǎn)，還保留了響應(yīng)式的潛力。

未來，如果你要進(jìn)一步探索高級(jí)策略，例如：

• 超時(shí)與重試策略的組合優(yōu)化；
• 與 Resilience4j 集成實(shí)現(xiàn)熔斷與限流；
• 日志鏈路追蹤與可觀測(cè)性增強(qiáng)；

RestClient 都能為你提供穩(wěn)定而靈活的基礎(chǔ)。

一句話總結(jié)：RestClient 是 Spring Boot 3.x 下的首選同步 HTTP 客戶端，實(shí)現(xiàn)了“簡(jiǎn)潔與強(qiáng)大”的最佳平衡。