Spring @Recover修改返回类型后针对自定义异常不生效问题咨询

云原生阿岚

2026-9-26

Spring Retry @Recover方法自定义返回类型不触发问题解决方案

问题原因

该问题核心是Spring Retry的@Recover方法匹配规则限制，结合你返回String正常、自定义类型异常的场景，常见原因如下：

返回类型路径不一致：Spring Retry匹配恢复方法时要求返回类型必须和@Retryable方法的返回类型完全一致，包括全类名路径。如果两个方法导入的MyOwnType属于不同包，就会匹配失败。String是JDK原生类不会存在导包错误，因此之前的逻辑可以正常运行。
版本兼容性bug：1.3.x版本之前的Spring Retry存在泛型擦除导致的自定义类型匹配缺陷，非JDK原生的自定义返回类型会出现匹配失败的情况。
多恢复方法匹配冲突：如果当前类中存在多个@Recover标注的方法，Spring Retry可能会优先匹配到其他参数兼容但返回类型不符的方法，导致目标恢复方法不触发。

解决方法

检查类导入路径：确认@Retryable方法和@Recover方法中引用的MyOwnType、MyException的import路径完全一致，没有错引不同包下的同名类。
强制绑定重试方法：使用Spring Retry 1.3+版本提供的recoverFor属性，明确指定当前恢复方法关联的重试方法名，避免匹配混乱：

@Recover(recoverFor = "getSomething")
public MyOwnType recover(MyException exception, String performanceId) {
     log.info("In recover method!!!!!!!!!!!!!!!!!!");
     return new MyOwnType();
}