WebClient响应式HTTP客户端与原生的对比

1. WebClient核心特性

• Spring 5推出的响应式HTTP客户端
• 基于Reactor Netty/Jetty Reactor
• 支持异步非阻塞I/O和背压

2. 使用示例

// 创建
WebClient client = WebClient.builder()
    .baseUrl("https://api.example.com")
    .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
    .build();

// GET请求——响应式
Mono<User> user = client.get()
    .uri("/users/{id}", 123)
    .retrieve()
    .bodyToMono(User.class);

// POST请求
Flux<Order> orders = client.post()
    .uri("/orders/search")
    .body(Mono.just(query), QueryParam.class)
    .retrieve()
    .bodyToFlux(Order.class);

// 异常处理
.retrieve()
.onStatus(HttpStatus::is4xxClientError, resp -> 
    resp.bodyToMono(String.class).map(ClientException::new))

// exchange()方法——更底层
.bodyToMono(User.class)
.timeout(Duration.ofSeconds(5))
.retry(3);

3. 对比RestTemplate | 特性 | RestTemplate | WebClient | |------|------|------| | 模型 | 同步阻塞 | 异步非阻塞 | | 线程 | 请求线程等待I/O | EventLoop复用 | | 背压 | 不支持 | 支持（响应式流） | | 流式处理 | 无 | 支持Flux流式消费 | | 错误处理 | try-catch | onStatus + 操作符 | | 超时配置 | RequestConfig | timeout()操作符 |

4. 对比OkHttp | 特性 | OkHttp | WebClient | |------|------|------| | 模型 | 同步+异步回调 | 响应式流 | | 连接池 | 支持 | 支持 | | 拦截器 | Interceptor链 | Filter | | 背压 | 不支持 | 原生支持 | | Spring集成 | 需额外配置 | 原生集成 |

5. 选型建议

• RestTemplate：简单项目、阻塞调用（已被标记微废弃）
• WebClient：全新项目、微服务间调用、响应式栈
• OkHttp：需要精细控制HTTP层（HTTP/2、WebSocket）
• AsyncHttpClient：纯异步场景（已维护模式）

6. 性能对比

• 低并发下差异不大
• 高并发（>1000 QPS）：WebClient优势显著（线程少、内存低）
• 背压保护：WebClient可防止下游慢导致内存爆炸