Spring Boot WebClient URL含Basic Auth遇401未授权问题求助

首先明确：WebClient（基于Reactor Netty）默认会自动解析URL中的用户名密码，将其转换成标准的Authorization: Basic <base64编码串>请求头，同时会把URL中的认证信息剥离掉——这就是你日志里只看到/api/route而看不到用户名密码的原因。如果你的目标服务器仅支持从URL中读取Basic Auth信息，而不处理Authorization头，就会返回401；而Postman内部会同时兼容两种传递方式，所以能正常请求。

针对这个问题，有两种解决思路：

方案一：强制WebClient保留URL中的认证信息 #

如果你必须通过URL传递认证参数，需要禁用Reactor Netty的自动认证处理逻辑，让它原封不动地发送带用户名密码的URL。配置示例如下：

import org.springframework.http.client.reactive.ReactorClientHttpConnector;
import reactor.netty.http.client.HttpClient;
import reactor.netty.http.client.HttpClientOption;

// 构建WebClient时自定义HttpClient
WebClient webClient = WebClient.builder()
        .clientConnector(new ReactorClientHttpConnector(
                HttpClient.create()
                        .wiretap(true) // 开启后可以在日志里看到完整的请求URL，方便验证
                        .disable(HttpClientOption.AUTH_AUTO_RESPONSE) // 禁用自动转换认证信息为Header
        ))
        .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
        .build();

配置后，WebClient会直接发送你构造的完整URL，不会剥离认证信息，服务器就能从URL中读取到用户名和密码了。

方案二：改用标准的Authorization头传递认证信息（推荐） #

URL中明文携带密码存在安全风险，更规范的做法是手动构造Basic Auth头传递，这也是HTTP协议推荐的方式。如果你的服务器支持标准Basic Auth，用这种方式更稳妥：

import java.nio.charset.StandardCharsets;
import java.util.Base64;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;

String username = "你的用户名";
String password = "你的密码";
// 构造Basic Auth头
String basicAuth = "Basic " + Base64.getEncoder()
        .encodeToString((username + ":" + password).getBytes(StandardCharsets.UTF_8));

WebClient webClient = WebClient.builder()
        .defaultHeader(HttpHeaders.AUTHORIZATION, basicAuth)
        .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
        .build();

调用时直接使用不带认证信息的URL：http://hostname:8080/api/route即可。

排查建议 #

• 开启wiretap(true)后，查看日志中的完整请求URL和请求头，确认认证信息的传递方式是否符合预期；
• 用抓包工具（如Wireshark、Fiddler）对比WebClient和Postman的请求，看两者的URL、请求头差异，定位服务器拒绝的具体原因。

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