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,即使版本兼容也无法触发重试逻辑
- 状态判断方法写错:原代码中判断5xx状态用的
具体修复步骤
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
相关产品推荐
相关产品推荐

