spring-retry 异常重试

chy1984

已于 2023-10-15 23:48:47 修改

阅读量413

点赞数

分类专栏：常用API 文章标签： spring spring-retry 异常重试 Retryable Recover

于 2023-07-04 07:30:00 首次发布

本文链接：https://blog.csdn.net/chy_18883701161/article/details/131514286

版权

常用API 专栏收录该内容

24 篇文章 2 订阅

订阅专栏

spring-retry 和spring的事务管理一样，有声明式（注解）、编程式（自行写代码）2种使用方式，更推荐使用声明式，不侵入原有业务逻辑。声明式是基于aop实现的，还需要引入aop相关依赖，同样具有aop相关的坑，比如以下几种情况 spring-retry 不生效

@Retryable、@Recover 修饰非public方法
@Retryable 修饰的方法被当前类中的其它方法调用
方法内不能 try catch 吞掉了异常，没有往外抛

依赖

<dependency>
    <groupId>org.springframework.retry</groupId>
    <artifactId>spring-retry</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

启动类

启用 spring-retry

@EnableRetry

声明式重试

@Service
public class UserServiceImpl implements UserService {

    @Retryable
    // @Retryable(value = Exception.class, maxAttempts = 3, backoff = @Backoff(delay = 2000, multiplier = 1.5))
    public UserPo getUserInfo(Long userId, String username) {

    }

    @Recover
    public UserPo getUserInfoRecover(Exception e, Long userId, String username) {

    }
    
}

@Retryable 抛出指定异常时自动重试，如果达到最大重试次数还是不行，会自动调用当前类中 @Recover 标注的形参表、返回值类型相同的方法兜底。

@Recover 方法可选，返回值类型和@Retryable方法保持一致，第一个参数和@Retryable指定的异常类型保持一致，后续参数和@Retryable方法形参表保持一致（末尾的参数可以省略，但参数顺序不能乱）。

@Retryable 常用属性

value、include、exclude：指定要处理的异常类型，可搭配使用
maxAttempts：最大尝试次数，默认3。注意是尝试，不是重试，第一次调用就算1次尝试，即默认为1次初始调用 + 2次重试
backoff：重试时间间隔配置
- delay：延迟时间（ms，默认为0），delay不为0时才取delay的值，否则取value（默认1000ms）的值。
- multiplier：间隔倍数，为正数时才有效，eg.delay=5s、multiplier=3，则初次调用失败后间隔 5s 进行第1次重试，第1次重试失败后间隔 5s * 3 = 15s 进行第2次重试，第2次重试失败后间隔 15s * 3 = 45s 后再次重试，每次都是在前一次间隔时间的基础上*multiplier，默认为0 固定重试间隔时间。
- maxDelay：最大延迟时间，重试间隔超过maxDelay时取maxDelay，默认30s。