Spring WebClient 如何为Client Credentials OAuth2添加自定义Token请求头
问题根因
你在业务WebClient层面配置的默认请求头,仅作用于最终调用受保护REST资源的业务请求。Spring Security OAuth2客户端组件内部,是通过独立的、不受业务WebClient配置管控的HTTP客户端发起/oauth/token端点的取号请求,两条链路的请求头配置完全隔离,因此自定义头不会自动传递到token认证请求上,这也是你之前配置不生效的核心原因。
实现方案
核心思路是替换框架默认的ClientCredentials模式Token获取组件,在其内部发起token请求时主动携带自定义请求头,具体步骤如下:
- 初始化自定义的
WebClientReactiveClientCredentialsTokenResponseClient(响应式栈下负责实际发起token请求的核心组件) - 为该组件内部使用的WebClient添加请求过滤器,在每次发起token请求时注入要求的
Custom-Header - 将自定义的Token获取组件绑定到OAuth2授权过滤器上,替换默认实现
对应改造后的完整代码:
// 基础ClientRegistration配置(保持你原有逻辑不变) ClientRegistration client = ClientRegistration .withRegistrationId(authUser) .tokenUri(authUrl) .clientId(authUser) .clientSecret(authPassword) .authorizationGrantType(AuthorizationGrantType.CLIENT_CREDENTIALS) .scope(authScope) .build(); ReactiveClientRegistrationRepository clientRegistrations = new InMemoryReactiveClientRegistrationRepository(client); // 新增:自定义ClientCredentials模式的Token响应客户端 WebClientReactiveClientCredentialsTokenResponseClient tokenResponseClient = new WebClientReactiveClientCredentialsTokenResponseClient(); // 替换客户端内部的默认WebClient,增加自定义请求头逻辑 tokenResponseClient.setWebClient(WebClient.builder() .filter((request, exchangeFunction) -> { // 在此处注入要求的自定义请求头 request.headers().add("Custom-Header", customHeader); return exchangeFunction.exchange(request); }) .build() ); // 初始化OAuth2授权过滤器 ServerOAuth2AuthorizedClientExchangeFilterFunction oauthFilter = new ServerOAuth2AuthorizedClientExchangeFilterFunction( clientRegistrations, new UnAuthenticatedServerOAuth2AuthorizedClientRepository()); // 绑定自定义的Token获取客户端,替换默认实现 oauthFilter.setAccessTokenResponseClient(tokenResponseClient); oauthFilter.setDefaultClientRegistrationId(authUser); // WebClient构建逻辑保持原有配置即可 this.webClient = WebClient.builder() .filter(oauthFilter) .defaultHeaders(httpHeaders -> { httpHeaders.add("Custom-Header", customHeader); }) .build();
注意事项
- 不需要担心自定义配置会影响业务请求的请求头逻辑:绑定到token获取客户端的头逻辑,仅会作用于发往
/oauth/token的认证请求,业务请求的头逻辑完全保留原有配置的行为 - 如果存在多套ClientRegistration配置,可以在过滤器逻辑中根据当前请求对应的registrationId,动态匹配不同的自定义头值,避免硬编码
- 该方案适配Spring Security 5.2及以上的响应式栈版本,如果是Servlet栈场景,可采用完全一致的思路:替换默认的
RestTemplateOAuth2AccessTokenResponseClient,给其内部的RestTemplate增加自定义请求头拦截器即可
内容的提问来源于stack exchange,提问作者Guillermo Nasi
相关产品推荐
相关产品推荐

