You need to enable JavaScript to run this app. WebFlux集成Resilience4j自定义Retry运行报Mono.retryWhen方法找不到异常
优惠活动
大模型
产品
解决方案
定价
更多

WebFlux集成Resilience4j自定义Retry运行报Mono.retryWhen方法找不到异常

问题定位与修复方案

核心报错根因

你遇到的NoSuchMethodError: reactor.core.publisher.Mono.retryWhen(...)本质是依赖版本不兼容导致的方法签名不匹配:

  • 你手动指定的reactor-core 3.4.3和当前引入的Resilience4j 1.6.1版本适配范围不匹配。Resilience4j 1.6.1编译时适配的Reactor核心版本是3.3.x系列,Reactor 3.4.x迭代时调整了retryWhen方法的入参泛型定义,运行时找不到对应签名的方法,直接抛出错误。
  • 你的业务代码本身存在逻辑错误,进一步放大了运行时异常:
    • 状态判断方法写错:原代码中判断5xx状态用的is5xxClientError()不存在,正确方法为is5xxServerError()
    • 错误流构造方式错误:在onStatus回调中同步抛出普通Exception,没有通过Mono.error()返回错误信号,导致WebClient无法正常传递错误状态
    • 异常类型不匹配:你配置的重试规则仅针对ServerException,原代码抛出的是未指定类型的普通Exception,即使版本兼容也无法触发重试逻辑

具体修复步骤

1. 对齐依赖版本

  • 移除POM中手动硬编码的reactor-core版本标签,交由Spring Boot官方BOM自动管理全链路兼容的Reactor版本,避免手动指定版本引发的依赖冲突。
  • 按当前Spring Boot版本匹配Resilience4j版本:
    • 若使用Spring Boot 2.4.x及以上(自带Reactor 3.4.x),将Resilience4j版本升级到1.7.0及以上,该版本起Resilience4j正式适配Reactor 3.4.x的API。
    • 若必须保留Resilience4j 1.6.1版本,将Reactor版本降级到3.3.19.RELEASE,匹配Resilience4j 1.6.1的适配范围。
  • 额外注意:resilience4j-spring-boot2和resilience4j-reactor版本必须保持一致,避免跨版本API不兼容。

2. 修正WebClient请求逻辑

将原onStatus块的错误处理逻辑替换为符合响应式流规范的写法,保证错误类型匹配重试规则:

.retrieve()
.onStatus(HttpStatus::isError, clientResponse -> {
    LOGGER.error("请求调用失败,响应状态码: {}", clientResponse.statusCode());
    if (clientResponse.statusCode().is5xxServerError()) {
        // 必须返回Mono.error构造错误流,异常类型匹配Retry配置的重试规则
        return Mono.error(new ServerException("服务端调用异常: " + clientResponse.statusCode()));
    }
    // 4xx客户端错误匹配Retry配置的忽略规则
    return Mono.error(new ClientException("客户端调用异常: " + clientResponse.statusCode()));
})
.bodyToMono(MyResponse.class)
// RetryOperator必须放在错误兜底逻辑之前,保证重试逻辑优先处理错误信号
.transform(RetryOperator.of(retryConfig))
.onErrorResume(ex -> myFallbackMethod(ex))

3. 校验Retry Bean配置

  • 原Retry Bean配置没有问题,注意retryExceptions和ignoreExceptions的匹配逻辑:当抛出的异常同时命中重试和忽略规则时,会优先走忽略逻辑不触发重试,不需要额外修改。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 11:24:03