Spring Boot 的 @Retryable 注解仅对跨 Bean 的方法调用生效，同一 Bean 内的内部方法调用会绕过 AOP 代理，导致重试逻辑不触发——这是最常见的重试失效根源。
spring boot 的 `@retryable` 注解仅对跨 bean 的方法调用生效，同一 bean 内的内部方法调用会绕过 aop 代理，导致重试逻辑不触发——这是最常见的重试失效根源。
在 Spring 中，@Retryable 依赖于 Spring Retry 模块提供的 AOP 代理机制实现。该机制通过动态代理（JDK Proxy 或 CGLIB）拦截目标方法调用，并在异常发生时按配置执行重试逻辑。但这一拦截仅发生在“外部 Bean 调用当前 Bean 的 public 方法”时；若调用发生在同一个 Bean 内部（如 someMethod1() 直接调用 this.retry()），则属于普通 Java 方法调用，完全绕过代理层，@Retryable 注解形同虚设。
例如以下代码将无法触发重试：
@Service
public class MyService {
public void someMethod1() {
retry(); // ❌ 内部调用：无代理，不重试
}
public void someMethod2() {
retry(); // ❌ 同样无效
}
@Retryable(maxAttempts = 3, backoff = @Backoff(delay = 1000))
public void retry() {
System.out.println("Executing...");
throw new RuntimeException("Simulated failure");
}
}
✅ 正确做法：确保 @Retryable 方法被另一个 Spring 管理的 Bean 调用。推荐解耦方式如下：
@Service
public class RetryService {
@Retryable(maxAttempts = 3, value = RuntimeException.class,
backoff = @Backoff(delay = 1000, multiplier = 2))
public void executeWithRetry() {
System.out.println("Attempt: " + LocalDateTime.now());
throw new RuntimeException("Transient error");
}
}
@Service
public class BusinessService {
private final RetryService retryService;
public BusinessService(RetryService retryService) {
this.retryService = retryService;
}
public void someMethod1() {
retryService.executeWithRetry(); // ✅ 跨 Bean 调用，代理生效
}
public void someMethod2() {
retryService.executeWithRetry(); // ✅ 同样有效
}
}
⚠️ 注意事项：
- @Retryable 方法必须是 public，且不能是 private、protected 或包级私有；
- 若使用 CGLIB 代理（如 @EnableRetry(proxyTargetClass = true)），目标类不能为 final，方法也不能是 final；
- 运行时动态修改 maxAttempts 不被原生支持——@Retryable 属性在编译期/代理创建时即固化。如需动态控制，应改用编程式重试（RetryTemplate）：
@Service
public class DynamicRetryService {
private final RetryTemplate retryTemplate;
public DynamicRetryService(RetryOperations retryTemplate) {
this.retryTemplate = retryTemplate;
}
public void executeWithDynamicAttempts(int maxAttempts) {
RetryTemplate template = RetryTemplate.builder()
.maxAttempts(maxAttempts)
.fixedBackoff(1000)
.retryOn(RuntimeException.class)
.build();
template.execute(context -> {
System.out.println("Dynamic attempt #" + context.getRetryCount());
throw new RuntimeException("Try again");
});
}
}
总结：@Retryable 是声明式重试的便捷方案，但其生效严格依赖 Spring AOP 代理边界。务必避免同一 Bean 内部调用，优先采用服务拆分 + 跨 Bean 调用；对需运行时动态调整重试策略的场景，应选用 RetryTemplate 实现编程式控制，兼顾灵活性与可测试性。
