Spring Boot WebClient配置带Basic认证的代理遇407错误，求正确配置

问题原因分析 #

你遇到的407 Proxy Authentication Required错误，核心原因是Proxy-Authorization头的添加时机错误：

• WebClient的defaultHeader()方法是将头添加到发给目标API服务器的请求中，而代理认证需要在与代理服务器建立连接的CONNECT请求阶段就提供认证信息。
• Reactor Netty的HttpClient代理处理器不会读取WebClient设置的普通请求头，因此代理服务器在连接阶段收不到认证信息，返回407错误。

最佳配置方式 #

正确的做法是在Reactor Netty的HttpClient代理配置中直接指定认证信息，无需手动在WebClient中添加Proxy-Authorization头。

修改后的配置代码 #

配置带认证的HttpClient

import org.springframework.http.HttpHeaders;
import org.springframework.http.client.reactive.ReactorClientHttpConnector;
import org.springframework.web.reactive.function.client.ExchangeFilterFunction;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;
import reactor.netty.http.client.HttpClient;
import reactor.netty.transport.ProxyProvider;

@Bean
public HttpClient httpClient() {
    return HttpClient.create()
        .proxy(proxy -> proxy
            .type(ProxyProvider.Proxy.HTTP)
            .host(HTTP_PROXY_URL)
            .port(HTTP_PROXY_PORT)
            // 方式1：直接传入用户名密码，框架自动生成Basic认证头
            .username(PROXY_USERNAME)
            .password(passwordSupplier -> PROXY_PASSWORD)
            // 方式2：若已有Base64编码的认证字符串，直接设置头
            // .addHeader(HttpHeaders.PROXY_AUTHORIZATION, AUTH)
        );
}

简化WebClient配置

去掉无效的defaultHeader()配置：

@Bean
public WebClient webClient() {
    ReactorClientHttpConnector connector = new ReactorClientHttpConnector(httpClient());

    return WebClient.builder()
        .clientConnector(connector)
        .filters(exchangeFilterFunctions -> {
            exchangeFilterFunctions.add(logRequest());
            exchangeFilterFunctions.add(logResponse());
        })
        .build();
}

原理说明 #

Reactor Netty的ProxyProvider会在发起代理连接的CONNECT请求中自动携带认证信息，这是代理服务器期望接收认证的正确阶段。相比手动添加请求头，这种方式能确保认证信息被代理处理器正确读取并发送，避免407错误。

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