WebClient 替代 RestTemplate 的核心是转向响应式编程，需调整调用逻辑、错误处理和线程上下文；推荐通过 builder 配置 baseUrl、默认头及连接池超时；请求采用链式 API，错误用 onStatus 声明式处理，重试用 retryWhen；同步降级可用 block()（慎用），并行用 Mono.zip。
直接用 WebClient 替代 RestTemplate，核心不是“换个类名”，而是切换到响应式编程模型。RestTemplate 是同步阻塞的，WebClient 是异步非阻塞的，返回值从 User 变成了 Mono<User> 或 Flux<User>。迁移时需同步调整调用方逻辑、错误处理和线程上下文管理。
创建和配置 WebClient 实例
推荐通过 WebClient.builder() 构建，支持全局基础配置：
- 设置
baseUrl统一前缀，避免每个请求重复拼接 - 用
defaultHeader注入通用头（如Content-Type: application/json） - 通过
clientConnector配置连接池、超时等底层参数（如 Netty 的ConnectionProvider和HttpClient） - 生产环境务必显式配置连接超时（
connectTimeout）和读超时（responseTimeout），RestTemplate 的超时配置在 WebClient 中不生效
发起 GET/POST 等基本请求
API 设计更函数化，链式调用清晰表达意图：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- GET 请求：用
webClient.get().uri("/users/{id}", 123).retrieve().bodyToMono(User.class) - POST 请求：用
webClient.post().uri("/users").bodyValue(user).retrieve().bodyToMono(User.class) - 需要获取完整响应（含状态码、头信息）时，改用
exchangeToMono或retrieve().toEntity(User.class) - 路径参数支持字符串模板或
UriBuilder；查询参数可用uri(uriBuilder -> ...)构建
统一处理错误与重试
不再依赖 try-catch 包裹整个调用，而是用响应式操作符声明式处理：
- 用
onStatus拦截特定 HTTP 状态码，例如onStatus(HttpStatus::is4xxClientError, r -> Mono.error(new BusinessException("客户端错误"))) - 用
onStatus+flatMap解析错误响应体（如返回 JSON 错误详情） - 重试用
retryWhen配合Retry.backoff，可设定最大次数、退避间隔、条件过滤（如只重试 503 或网络异常） - 注意：默认情况下 WebClient 不自动重试，必须显式添加
适配现有同步业务逻辑
若服务尚未全面响应式化，可安全“降级”使用：
- 对单个
Mono调用，用block()同步等待结果（仅限测试或非关键路径，禁用于 WebFlux controller） - 多个并行请求用
Mono.zip(a, b, c)合并，比 RestTemplate 串行调用节省大量等待时间 - 配合
ReactorContext或ContextView透传 MDC 日志上下文，避免日志链路丢失 - 如需完全无感迁移，可封装一层工具方法，内部
block()并抛出运行时异常，但长期仍建议逐步转向纯响应式链路
