You need to enable JavaScript to run this app. Spring WebClient 如何避免OAuth2客户端凭证模式下重复发起访问令牌请求
优惠活动
大模型
产品
解决方案
定价
更多

Spring WebClient 如何避免OAuth2客户端凭证模式下重复发起访问令牌请求

问题根源
  • 现有WebClient的OAuth2过滤逻辑没有做token获取的并发去重与缓存复用,20个设备的请求被并发触发时,每个请求都会独立检查本地存储的token,因为初始状态下没有有效token,每个请求都会单独向认证服务器发起一次token获取请求,最终累计产生20次认证调用。
  • 业务代码中重复手动设置的clientRegistrationId属性,会让OAuth2过滤器跳过默认配置的缓存逻辑,重新走一遍独立的token获取流程,无法复用已有结果。
具体调整方案

1. 配置类优化

删除原有配置中手动注入非响应式ClientRegistrationRepository的冗余逻辑,Spring Boot会根据配置文件中的OAuth2参数自动装配对应的响应式注册仓库,不需要手动查询。核心调整点是给授权管理器增加token获取的缓存去重逻辑,替代原来无缓存的实现:

@Configuration
public class OAuth2WebClientConfig {

    @Bean
    public WebClient webClient(ExchangeFilterFunction oauth2FilterFunction) {
        return WebClient.builder()
                .filter(oauth2FilterFunction)
                .build();
    }

    @Bean
    public ExchangeFilterFunction oauth2FilterFunction(ReactiveClientRegistrationRepository clientRegistrationRepository) {
        // 初始化内存授权客户端存储,用于持久化缓存已获取的access token
        InMemoryReactiveOAuth2AuthorizedClientService authorizedClientService =
                new InMemoryReactiveOAuth2AuthorizedClientService(clientRegistrationRepository);

        AuthorizedClientServiceReactiveOAuth2AuthorizedClientManager authorizedClientManager =
                new AuthorizedClientServiceReactiveOAuth2AuthorizedClientManager(
                        clientRegistrationRepository, authorizedClientService);

        // 配置客户端凭证模式的token提供者,设置10秒的时间偏移量,避免拿到即将过期的token
        ClientCredentialsReactiveOAuth2AuthorizedClientProvider baseTokenProvider =
                new ClientCredentialsReactiveOAuth2AuthorizedClientProvider();
        baseTokenProvider.setClockSkew(Duration.ofSeconds(10));

        // 核心:对web注册ID对应的token获取请求做并发缓存,所有并发请求共享同一个token获取结果,仅触发一次远程认证调用
        Mono<OAuth2AuthorizedClient> cachedTokenFlow = baseTokenProvider
                .authorize(OAuth2AuthorizationContext.withClientRegistrationId("web")
                        .principal(new Authentication() {
                            @Override
                            public Collection<? extends GrantedAuthority> getAuthorities() {
                                return Collections.emptyList();
                            }

                            @Override
                            public Object getCredentials() {
                                return "";
                            }

                            @Override
                            public Object getDetails() {
                                return "";
                            }

                            @Override
                            public Object getPrincipal() {
                                return "system";
                            }

                            @Override
                            public boolean isAuthenticated() {
                                return true;
                            }

                            @Override
                            public void setAuthenticated(boolean isAuthenticated) throws IllegalArgumentException {

                            }

                            @Override
                            public String getName() {
                                return "system";
                            }
                        }).build())
                // 按照认证服务器返回的token有效期设置缓存窗口,通常设置为token有效期减10秒的偏移量
                .cache(Duration.ofMinutes(5));

        // 替换默认的token提供者,所有token请求直接返回缓存好的结果
        authorizedClientManager.setAuthorizedClientProvider(context -> cachedTokenFlow);

        ServerOAuth2AuthorizedClientExchangeFilterFunction oauthFilter =
                new ServerOAuth2AuthorizedClientExchangeFilterFunction(authorizedClientManager);
        oauthFilter.setDefaultClientRegistrationId("web");
        return oauthFilter;
    }
}

2. 业务代码调整

删除每个业务请求中手动设置的clientRegistrationId属性,避免过滤器重复触发独立的token解析流程:

private void getData(List<Device> initlist) {
    logger.info("** start getDeviceData **");

    List<Mono<DeviceDto>> jsonDeviceList = initlist.stream()
            .map(device -> webClient.post()
                    .uri(infoUri)
                    .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
                    .header(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON_VALUE)
                    .body(Mono.just(device.getMacAddress()), String.class)
                    .retrieve()
                    .bodyToMono(DeviceDto.class))
            .collect(Collectors.toList());

    ObjectMapper mapper = new ObjectMapper();
    Flux<DeviceDto> mergedMonos = Flux.fromIterable(jsonDeviceList).flatMapSequential(Function.identity());
    mergedMonos.map(device -> mapper.valueToTree(device)).collectList().subscribe(list -> {
        generateCsv(list);
    });
}
调整效果
  • 冷启动场景下,20个并发设备请求只会触发1次对认证服务器的token获取调用,所有请求直接复用缓存好的token发起业务请求。
  • 缓存窗口内的后续业务请求,完全不会触发对认证服务器的调用,直到缓存到期后才会发起一次新的token获取请求。

内容的提问来源于stack exchange,提问作者angus

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 05:15:04