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
相关产品推荐
相关产品推荐

