前言
在实际的软件开发中，尤其是在涉及网络请求、数据库操作或外部服务调用的场景下，我们常常会遇到一些临时性故障（Transient Failures），例如网络波动、数据库连接超时、第三方 API 暂时不可用等。面对这些问题，一种常见的解决方案就是自动重试机制。
Spring Retry 是 Spring 提供的一个模块，它可以帮助我们以声明式的方式为方法添加重试功能，从而提升系统的健壮性和可用性。
一、什么是 Spring Retry？
Spring Retry 是 Spring 框架中的一个子项目，提供了对方法调用失败后进行自动重试的支持。它不仅支持简单的重试逻辑，还支持重试策略、回退策略以及与 Spring AOP 集成，使得我们可以非常方便地在业务代码中加入重试逻辑。
二、Spring Retry 的核心组件
1. RetryTemplate
RetryTemplate 是 Spring Retry 的核心类之一，它封装了重试逻辑的执行过程。你可以通过配置 RetryPolicy 和 BackOffPolicy 来定义重试次数和等待策略。
RetryTemplate retryTemplate = new RetryTemplate();// 设置最多重试3次（包括第一次尝试）
retryTemplate.setRetryPolicy(new SimpleRetryPolicy(3));// 设置固定间隔2秒再重试
retryTemplate.setBackOffPolicy(new FixedBackOffPolicy(2000L));retryTemplate.execute(context -> {// 调用可能会失败的方法someService.doSomething();return null;
});
2. RetryPolicy
定义哪些异常需要重试，以及最大重试次数。常用的有：
SimpleRetryPolicy：基于次数的重试。ExceptionClassifierRetryPolicy：根据异常类型决定是否重试。NeverRetryPolicy：从不重试。AlwaysRetryPolicy：无限重试。
3. BackOffPolicy
定义重试之间的等待策略。常用的有：
FixedBackOffPolicy：固定时间间隔。ExponentialBackOffPolicy：指数退避策略（推荐）。NoBackOffPolicy：不等待。
4. RetryListener
可以监听重试的不同阶段，比如开始、重试、结束等事件，用于日志记录或监控。
三、使用注解方式实现重试（推荐）
Spring Retry 支持通过注解的方式简化重试逻辑的编写，只需在方法上添加 @Retryable 注解即可。
1. 引入依赖（Maven）
<dependency><groupId>org.springframework.retry</groupId><artifactId>spring-retry</artifactId><version>1.3.5</version>
</dependency><!-- 同时需要启用 AspectJ -->
<dependency><groupId>org.aspectj</groupId><artifactId>aspectjweaver</artifactId><version>1.9.7</version>
</dependency>
2. 启用 Retry 功能
在配置类或启动类上加上 @EnableRetry 注解：
@SpringBootApplication
@EnableRetry
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}
}
3. 在方法上使用 @Retryable
@Service
public class MyService {@Retryable(maxAttempts = 3, backoff = @Backoff(delay = 2000))public void doSomething() {// 可能抛出异常的方法体if (Math.random() < 0.7) {throw new RuntimeException("Temporary failure");}System.out.println("Success!");}
}
上面的例子表示：
- 最多尝试 3 次；
- 每次失败后等待 2 秒；
- 默认只对
RuntimeException进行重试。
你也可以指定特定异常：
@Retryable(value = {IOException.class}, maxAttempts = 5)
或者排除某些异常：
@Retryable(exclude = {SQLException.class})
四、@Retryable 注解参数详解
在使用 Spring Retry 的注解方式时，@Retryable 是最核心的注解之一。它提供了多个可配置项，用于定义方法的重试行为。下面是一个详细的参数说明表：
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
value / include | Class<? extends Throwable>[] | {RuntimeException.class} | 指定需要重试的异常类型，默认对所有 RuntimeException 进行重试。 |
exclude | Class<? extends Throwable>[] | {} | 排除某些异常类型，这些异常不会触发重试。 |
maxAttempts | int | 3 | 最大尝试次数（包括第一次调用）。 |
maxAttemptsExpression | String | null | 支持通过 SpEL 表达式动态设置最大尝试次数。 |
backoff | Backoff | @Backoff(delay = 1000L) | 设置退避策略，如固定延迟、指数退避等。 |
interceptorBeanName | String | "" | 自定义拦截器 Bean 名称（不常用）。 |
label | String | "" | 给重试操作添加标签，可用于监听器识别。 |
stateful | boolean | false | 是否为有状态重试（适用于幂等性要求高的场景）。 |
示例：更复杂的 @Retryable 配置
@Retryable(value = {IOException.class, TimeoutException.class},exclude = SQLException.class,maxAttempts = 5,backoff = @Backoff(delay = 2000, multiplier = 1.5, maxDelay = 10000),stateful = true
)
public void retryableMethod() {// 方法逻辑
}
在这个例子中：
- 只对
IOException和TimeoutException进行重试； - 排除
SQLException； - 最多重试 5 次；
- 使用指数退避策略，初始延迟 2 秒，每次乘以 1.5 倍，最长延迟不超过 10 秒；
- 启用了有状态重试（适合涉及外部状态变更的操作）；
五、高级用法：结合监听器
你可以通过自定义监听器来记录每次重试的日志信息：
@Component
public class MyRetryListener implements RetryListener {@Overridepublic <T, E extends Throwable> boolean open(RetryContext context, RetryCallback<T, E> callback) {System.out.println("Retry: Open");return true;}@Overridepublic <T, E extends Throwable> void close(RetryContext context, RetryCallback<T, E> callback, Throwable throwable) {System.out.println("Retry: Close");}@Overridepublic <T, E extends Throwable> void onError(RetryContext context, RetryCallback<T, E> callback, Throwable throwable) {System.out.println("Retry: Error occurred, attempt " + context.getRetryCount());}
}
然后注册到 RetryTemplate 中：
retryTemplate.registerListener(new MyRetryListener());
六、注意事项
- 幂等性问题：重试操作必须是幂等的，否则重复执行可能导致数据错误。
- 事务控制：如果方法处于事务中，注意事务传播行为，避免因重试引发事务冲突。
- 性能影响：合理设置重试次数和等待时间，防止系统负载过高。
- 异步 vs 同步：Spring Retry 是同步的，如需异步重试需自行结合线程池处理。
七、总结
Spring Retry 是一个轻量但功能强大的重试框架，它通过模板模式和注解方式帮助开发者快速实现方法级别的自动重试。无论是在微服务调用、消息消费、数据库访问等场景中，都可以灵活应用。
合理使用 Spring Retry，可以让我们的系统更加健壮，有效应对各种瞬时故障。
