WebClient发起HTTP POST请求失败 同请求RestTemplate调用正常

这个报错本质是TCP连接被服务端单方面重置，同请求RestTemplate正常、WebClient异常，基本逃不开两个核心原因：

• WebClient默认基于Reactor Netty实现，默认开启HTTP连接池复用，当池子里缓存的空闲连接已经被服务端主动关闭（多数对外HTTP服务的空闲连接超时在30s以内，远短于Reactor Netty默认的连接空闲超时），客户端拿失效连接发请求就会触发这个错误。RestTemplate默认使用SimpleClientHttpRequestFactory，每次请求新建TCP连接，不存在复用失效连接的问题。
• Reactor Netty默认会尝试协商HTTP/2协议，部分老旧服务、API网关不支持HTTP/2，协商阶段就会直接断开连接，不会返回任何HTTP响应；另外如果WebClient没有配置和RestTemplate完全一致的请求头（尤其是Content-Type、Authorization、Accept），部分服务端校验不通过也会直接断连。

按优先级依次验证即可：

1. 重构WebClient的底层HttpClient配置，强制使用HTTP/1.1，调整连接池空闲超时规则，从根源避免复用失效连接：

import io.netty.channel.ChannelOption;
import io.netty.handler.timeout.ReadTimeoutHandler;
import io.netty.handler.timeout.WriteTimeoutHandler;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.client.reactive.ReactorClientHttpConnector;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.netty.http.HttpProtocol;
import reactor.netty.http.client.HttpClient;
import java.time.Duration;

// 配置底层HTTP客户端
HttpClient httpClient = HttpClient.create()
        .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
        .responseTimeout(Duration.ofSeconds(15))
        .doOnConnected(conn -> conn
                .addHandlerLast(new ReadTimeoutHandler(15))
                .addHandlerLast(new WriteTimeoutHandler(15)))
        // 强制使用HTTP/1.1，跳过HTTP/2协商
        .protocol(HttpProtocol.HTTP11)
        // 调整连接池配置：空闲连接20s自动回收，比多数服务端的空闲超时短
        .poolConfig(pool -> pool
                .maxIdleTime(Duration.ofSeconds(20))
                .evictionInterval(Duration.ofSeconds(30)));

// 构建全局复用的WebClient实例，统一配置公共请求头
WebClient marketoWebClient = WebClient.builder()
        .baseUrl("https://somehost/rest/v1/")
        .defaultHeader(HttpHeaders.AUTHORIZATION, "Bearer 39131a98-7a53-497f-8e04-ca08c35a7775:sj")
        .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
        .defaultHeader(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON_VALUE)
        .clientConnector(new ReactorClientHttpConnector(httpClient))
        .build();

2. 替换原有废弃的exchange()调用，避免连接泄露，同时补全必要的请求头配置：

ResponseEntity<LeadResponse> leadResponse = marketoWebClient.post()
        .uri("/leads.json")
        .bodyValue(lead)
        // 用官方推荐的exchangeToMono替代exchange，自动管理连接释放
        .exchangeToMono(clientResponse -> {
            if (clientResponse.statusCode().isError()) {
                // 错误场景必须读取响应体，否则会造成连接泄露
                return clientResponse.createException().flatMap(Mono::error);
            }
            return clientResponse.toEntity(LeadResponse.class);
        })
        .block();

3. 如果上述配置后仍报错，可临时关闭连接池做对比验证，对齐RestTemplate默认的每次新建连接行为，确认是否为连接复用导致的问题：

// 仅用于验证问题，生产环境不建议关闭连接池
HttpClient testClient = HttpClient.newConnection();

在配置文件中添加如下配置开启Reactor Netty的报文日志，可直接看到请求发送的全流程原始数据，快速定位是连接阶段失败还是请求发送阶段失败：

logging.level.reactor.netty.http.client=DEBUG

开启日志后对比WebClient和RestTemplate的请求头、请求体内容，确保两者完全一致，排除请求参数差异导致的服务端断连。

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