Spring WebClient中ExchangeFilterFunction在next.exchange()后重复执行如何解决
WebClient自定义过滤器重复执行问题解决方案
原因1:过滤器被重复注册到WebClient过滤器链
Spring Boot默认注入的WebClient.Builder是全局共享实例,如果你在全局配置中已经为该Builder添加过一次当前过滤器,或是多次调用builder.filter()方法添加同一个过滤器,过滤器链中会存在多个相同的过滤器实例,执行时自然会被调用多次。
对应解决方法
每次构建自定义WebClient时,先调用clone()方法得到独立的Builder实例,再添加专属配置,避免和全局配置互相影响:
WebClient webClient = builder.clone() .baseUrl(url) .filter(new GenericAwsXrayHandler(url)) .build();
你也可以在构建完成后打印过滤器数量确认是否重复注册:
// 输出值大于1则说明存在重复注册 System.out.println(webClient.filters().size());
原因2:请求对应的Mono被多次订阅
你当前的日志打印、链路子段初始化逻辑都写在filter方法的顶层,属于Publisher的组装逻辑,每次订阅请求返回的Mono,都会重新执行一次过滤器的全部逻辑,从而出现多次打印的情况。常见的多次订阅场景包括:手动多次调用subscribe()、多个下游操作符订阅同一个Mono、框架层面的重试机制触发等。
对应解决方法
如果确认是多次订阅导致的问题,可以根据业务场景选择使用cache()、share()操作符让多个订阅复用同一个请求结果,避免重复执行请求和过滤器逻辑。
代码优化建议
建议将过滤器的业务逻辑移入Mono.defer()中,确保只有实际触发订阅时才执行初始化逻辑,避免组装阶段就创建不需要的链路资源,也能避免订阅取消时的资源泄露问题:
@Override public Mono<ClientResponse> filter(final ClientRequest request, final ExchangeFunction next) { return Mono.defer(() -> { log.info("executing filter"); final Subsegment subsegment = AWSXRay.getGlobalRecorder().beginSubsegment(url); final TraceHeader header = getTraceHeader(request, subsegment); final ClientRequest clientRequest = ClientRequest.from(request) .header(TraceHeader.HEADER_KEY, header.toString()) .build(); logRequest(clientRequest); return next.exchange(clientRequest) .doOnSuccess(clientResponse -> { logResponse(clientResponse); addResponseInformation(subsegment, clientResponse); }) .doOnError(ex -> { subsegment.setFault(true); subsegment.addException(ex); }) .doFinally(x -> { AWSXRay.getGlobalRecorder().endSubsegment(subsegment); }); }); }
内容的提问来源于stack exchange,提问作者cezar
相关产品推荐
相关产品推荐

