You need to enable JavaScript to run this app. Spring WebClient中ExchangeFilterFunction在next.exchange()后重复执行如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.11 02:27:00