Java 中怎么使用 Spring Retry 实现接口调用失败重试-java教程-PHP中文网

Spring Retry 是 Spring 生态中轻量、声明式、可配置的重试框架，适合服务间调用失败时自动重试；需添加 spring-retry 和 spring-aop 依赖，启用 @EnableRetry，用 @Retryable 注解方法并可配异常类型、最大尝试次数与退避策略，支持 @Recover 降级及编程式 RetryTemplate 动态控制。

java 中怎么使用 spring retry 实现接口调用失败重试

Spring Retry 是 Spring 生态中轻量、声明式、可配置的重试框架，适合在服务间调用（如 HTTP、RPC）失败时自动重试。它不依赖外部中间件，通过注解或编程方式即可集成到 Spring Boot 项目中。

1. 添加依赖

在 Spring Boot 2.4+ 中，spring-retry 不再默认包含，需手动引入：

Gradle：

implementation 'org.springframework.retry:spring-retry'
implementation 'org.springframework.boot:spring-boot-starter-aop'

注意：spring-aop 必须存在，因为 @Retryable 依赖 AOP 代理生效。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

2. 启用重试支持

在主启动类或任意配置类上添加 @EnableRetry：

@SpringBootApplication
@EnableRetry
public class MyApp { ... }

3. 在方法上使用 @Retryable 注解

将该注解加在需要重试的业务方法上（必须是 Spring 管理的 Bean 中的 public 方法）：

@Service
public class UserService {

@Retryable(
value = {RestClientException.class, SocketTimeoutException.class},
maxAttempts = 3,
backoff = @Backoff(delay = 1000, multiplier = 2)
)
public User getUserById(Long id) {
return restTemplate.getForObject("https://api.example.com/users/" + id, User.class);
}

@Recover
public User recover(RestClientException e, Long id) {
log.warn("所有重试失败，返回默认用户，id={}", id);
return new User(0L, "default");
}
}

value：指定哪些异常触发重试（默认对所有异常重试）
maxAttempts：最大尝试次数（含首次调用，即 3 表示最多执行 3 次）
backoff.delay：首次重试延迟毫秒数（如 1000 = 1 秒）
backoff.multiplier：延迟倍增因子（如 2 表示第2次等 2s，第3次等 4s）
@Recover：定义降级方法，参数需匹配异常类型和原方法入参，返回值与原方法一致

4. 高级用法：动态重试策略

若需运行时决定是否重试或调整参数，可用编程式重试：

RetryTemplate template = RetryTemplate.builder()
.maxAttempts(5)
.exponentialBackoff(100, 2, 10000) // 初始延迟100ms，倍增2，上限10s
.retryOn(RestClientException.class)
.traverseCauses(true)
.build();

User user = template.execute(ctx -> {
return restTemplate.getForObject(url, User.class);
});