SpringBoot 微服务重试常用解决方案汇总与使用详解

适用于生产环境，特别是需要监控和灵活配置的微服务架构。

四、几种核心重试组件的具体集成和使用

4.1 Spring-Retry 集成和使用过程

4.1.1 导入依赖

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

4.1.2 启用重试功能

在主配置类添加 @EnableRetry。

4.1.3 创建一个服务类并使用@Retryable

@Service
public class OrderService {
    @Retryable(maxAttempts = 3, backoff = @Backoff(delay = 1000))
    public void createOrder() {
        // 业务逻辑
    }
}

4.1.4 增加一个测试接口

提供 Controller 调用上述 Service 方法。

4.1.5 效果测试

模拟异常抛出，观察控制台日志中的重试次数。

4.2 Resilience4j 集成与使用

4.2.1 导入依赖

<dependency>
    <groupId>io.github.resilience4j</groupId>
    <artifactId>resilience4j-spring-boot2</artifactId>
</dependency>

4.2.2 增加配置文件

resilience4j:
  retry:
    instances:
      api:
        maxAttempts: 3
        waitDuration: 1s

4.2.3 增加一个模拟重试的业务方法

@Retry(name = "api")
public String callApi() { ... }

4.2.4 增加一个测试接口

4.2.5 效果验证

查看 Actuator 端点获取重试指标。

4.3 Guava Retryer 集成与使用

4.3.1 导入核心依赖

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
</dependency>

4.3.2 创建重试工具类

Retryer<String> retryer = RetryerBuilder.<String>newBuilder()
    .retryIfExceptionOfType(IOException.class)
    .withWaitStrategy(WaitStrategies.exponentialBackoff(2, Duration.ofMillis(100)))
    .build();

4.3.3 业务方法中使用重试工具类

try {
    return retryer.call(() -> doSomething());
} catch (ExecutionException e) {
    throw new RuntimeException(e);
}

4.3.4 增加一个测试接口

4.3.5 效果测试

4.4 自定义注解 + AOP 实现

4.4.1 添加自定义注解

定义 @MyRetry 注解。

4.4.2 添加自定义切面类

编写 Aspect 拦截注解，实现 try-catch 重试逻辑。

4.4.3 使用自定义注解

在 Service 方法上标注 @MyRetry。

4.4.4 增加一个测试接口

4.4.5 效果测试

4.5 几种方案的对比

五、写在文末

本文总结了微服务开发中常见的四种重试实现方案。在实际项目中，建议优先使用 Spring Retry 或 Resilience4j，根据项目复杂度选择合适工具。同时务必保证业务接口的幂等性，并合理配置重试参数，避免引发系统震荡。