SpringBoot中如何优雅地使用重试

1 缘起

项目中使用了第三方的服务，

第三方服务偶尔会出现不稳定、连接不上的情况，

于是，在调用时为了保证服务的相对高可用，添加了超时连接重试，

当连接第三方服务超时时，多重试几次，比如3次，三次后仍连接不上，抛出异常，

在实际的测试过程中，重试一次即可连接到第三方服务，

提高了服务的可用性。

2 spring-retry

Spring提供了重试项目：spring-retry，用于处理项目中需要重试的方法，

spring-retry中提供了自定义参数，如重试次数、指定重试情况、重试延迟时间等，

满足不同的重试场景。

2.1 小插曲：试错过程

搜索SpringBoot如何使用重试注解时，发现需要使用spring-retry这个项目，在Maven仓库搜索了一下spring-retry，发现有多个版本，如下图，选择了最新版本2.0.4，启动项目时发现，无法运行。

环境：
Java8
SpringBoot2.4.5

xml 复制代码

<!-- https://mvnrepository.com/artifact/org.springframework.retry/spring-retry -->
<dependency>
    <groupId>org.springframework.retry</groupId>
    <artifactId>spring-retry</artifactId>
    <version>2.0.4</version>
</dependency>

异常信息如下，版本不一致，进入spring-retry项目，查看项目配置。

java: 无法访问org.springframework.retry.annotation.Backoff

错误的类文件: /D:/install/maven/apache-maven-3.8.8/my-repository/org/springframework/retry/spring-retry/2.0.4/spring-retry-2.0.4.jar!/org/springframework/retry/annotation/Backoff.class

类文件具有错误的版本 61.0, 应为 52.0

请删除该文件或确保该文件位于正确的类路径子目录中。

查看spring-retry项目的配置文件，发现java版本为17，所以，使用java8无法启动项目，

因此，需要选择spring-retry对应Java8的版本。

2.2 正确过程

2.2.1 配置依赖

不指定spring-retry版本，Maven会自动下载合适的版本，本次自动下载的版本为1.3.1。

xml 复制代码

<!-- https://mvnrepository.com/artifact/org.springframework.retry/spring-retry -->
<dependency>
    <groupId>org.springframework.retry</groupId>
    <artifactId>spring-retry</artifactId>
</dependency>

2.2.2 重试注解@Retryable

为方法添加@Retryable注解，即可在方法遇到异常时，重试指定次数。

常用参数如下，如有其他开发需求，可继续查看源码中的其他参数。

序号	参数	描述
1	value	触发重试的异常情况
2	maxAttempts	最大重试次数，默认重试3次
3	backoff	补偿机制，delay重试延迟时间，单位：毫秒；multiplier延迟时间比例，延迟的具体时间为delay*multiplier（multiplier>0时生效，默认multiplier为0），当multiplier为0时，延迟时间即为delay