Spring WebClient 如何全局忽略特定HTTP错误

原有方案失效的核心原因 #

之前的过滤器中通过onErrorResume捕获WebClientResponseException的逻辑完全不触发，本质是异常触发时机和过滤器执行阶段错位：

• 过滤器执行到next.exchange(request)时，拿到的是携带状态码的原始ClientResponse对象，此时哪怕状态码是4xx/5xx，也不会抛出异常
• WebClientResponseException是后续调用retrieve()时，由内置的默认错误判断逻辑生成抛出的，这个时机远晚于过滤器的响应处理阶段，因此过滤器层给响应流加的错误捕获逻辑根本接不到这个异常

全局生效的正确实现方案 #

要实现所有请求自动忽略特定错误，核心是在过滤器阶段拿到原始响应时，直接对匹配的错误状态码做拦截转换，在内置错误处理逻辑触发前就将其转为无异常的成功响应，从根源上避免异常抛出，完全不需要在单次请求中重复配置onStatus。
基础实现代码：

WebClient webClient = WebClient.builder()
    .filter((request, next) -> next.exchange(request)
        .flatMap(clientResponse -> {
            // 匹配需要全局忽略的错误状态码，可按需扩展为集合匹配
            if (clientResponse.statusCode().value() == 418) {
                // 构造无异常的成功响应，跳过后续默认错误抛出流程
                return Mono.just(ClientResponse.create(HttpStatus.OK).build());
            }
            // 其他状态码走原有正常逻辑
            return Mono.just(clientResponse);
        })
    ).build();

如果需要对被忽略的错误响应做日志排查，需要先读取原始响应体再完成资源释放，避免HTTP连接泄漏，可参考如下写法：

WebClient webClient = WebClient.builder()
    .filter((request, next) -> next.exchange(request)
        .flatMap(clientResponse -> {
            int status = clientResponse.statusCode().value();
            if (status == 418) {
                // 读取原始响应体内容用于日志，读取完成后丢弃内容释放连接
                return clientResponse.bodyToMono(String.class)
                    .defaultIfEmpty("")
                    .flatMap(body -> {
                        log.debug("全局捕获到需忽略的418响应，内容: {}", body);
                        return Mono.just(ClientResponse.create(HttpStatus.OK).build());
                    });
            }
            return Mono.just(clientResponse);
        })
    ).build();

方案优势 #

• 配置全局生效，不存在单次请求遗漏配置的问题
• 拦截逻辑执行顺序靠前，不会被默认的错误处理流程打断
• 可灵活扩展需要忽略的状态码集合，适配多场景的全局错误处理需求

内容的提问来源于stack exchange，提问作者Gbr