WebClient.Builder.build()与WebClient.create()的区别及使用报错排查

问题根因分析 #

无任何自定义配置的WebClient.builder().build()和WebClient.create()生成的实例逻辑完全等价，出现异常的核心原因是你使用的WebClient.Builder实例是Spring容器自动注入的，而非直接调用静态方法生成的无配置Builder，容器注入的Builder已经被全局自定义配置修改过属性，导致请求异常。

常见错误配置排查方向 #

你可以按以下优先级检查项目里的全局WebClient配置：

• 全局配置了错误的baseUrl、无效代理服务器，导致请求被转发到不可用的服务
• 全局配置了请求过滤器，篡改了请求路径、请求头，被目标服务拒绝返回503
• 全局配置了过短的连接/响应超时时间，请求未完成就被切断触发异常

解决方案 #

方案1：直接生成纯净WebClient实例

如果你不需要全局配置，直接调用静态builder方法生成无配置实例即可，和WebClient.create()效果完全一致：

// 手动调用静态方法，不受全局配置影响
WebClient webClient = WebClient.builder().build();

方案2：覆盖注入Builder的错误配置

如果需要保留全局配置的其他能力，可手动覆盖错误的配置项：

// 以覆盖baseUrl为例，根据实际错误配置调整对应方法即可
WebClient webClient = injectedBuilder
        .baseUrl("") // 清空错误配置的baseUrl
        .build();

内容的提问来源于stack exchange，提问作者Tony