⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 blog.csdn.net/qq_43546721/article/details/134848416 「IT·陈寒」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

1 引言

在实际的应用中，我们经常需要调用第三方API来获取数据或执行某些操作。然而，由于网络不稳定、第三方服务异常等原因，API调用可能会失败。为了提高系统的稳定性和可靠性，我们通常会考虑实现重试机制。

本文将深入探讨如何在Spring Boot项目中优雅地重试调用第三方API，并结合代码示例，展示具体实现方式。

2 重试机制的必要性

第三方API调用可能面临各种不可预测的问题，如网络超时、服务器故障等。为了应对这些问题，引入重试机制可以帮助我们：

提高系统的稳定性： 在面对临时性故障时，通过重试机制可以减轻对系统的影响，确保服务的可用性。
降低因故障而导致的用户体验差： 用户可能无法感知到一次短暂的故障，而重试机制可以在不干扰用户操作的情况下自动修复问题。

3 Spring Retry简介

Spring Retry是Spring框架提供的一个模块，它通过提供注解或编程方式的方式，帮助我们实现方法级别的重试机制。在Spring Boot中，可以很方便地集成并使用Spring Retry。

4 Spring Boot中使用Spring Retry实现重试

4.1 添加依赖

首先，我们需要在pom.xml中添加Spring Retry的依赖：

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

4.2 配置重试策略

在Spring Boot中，我们可以使用@Retryable注解来标记希望重试的方法，并配置相应的重试策略。

4.2.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;

@Service
public class ThirdPartyService {

    @Retryable(
        value = { RestClientException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public String callThirdPartyApi() {
        // 调用第三方API的逻辑
        // ...
    }
}

在上述示例中，@Retryable注解标记了callThirdPartyApi方法，指定了当发生RestClientException异常时进行重试。maxAttempts指定最大重试次数，backoff指定了重试间隔的初始延迟和延迟倍数。

4.3 降级处理

在实际应用中，除了重试，我们可能还希望在多次重试失败后执行降级操作，以避免一直等待不确定的恢复时间。

4.3.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Recover;
import org.springframework.retry.annotation.Retryable;

@Service
public class ThirdPartyService {

    @Retryable(
        value = { RestClientException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public String callThirdPartyApi() {
        // 调用第三方API的逻辑
        // ...
    }

    @Recover
    public String fallback() {
        // 降级处理逻辑
        // ...
    }
}

在上述示例中，@Recover注解标记了fallback方法，当callThirdPartyApi方法的重试次数达到上限时，将执行fallback方法中的降级逻辑。

5 异步重试

有时候，我们可能希望在异步任务中实现重试机制。Spring Retry同样提供了异步的支持。

5.1 异步方法的重试

5.1.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;

@Service
public class AsyncThirdPartyService {

    @Async
    @Retryable(
        value = { RestClientException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public CompletableFuture<String> callAsyncThirdPartyApi() {
        // 异步调用第三方API的逻辑
        // ...
    }
}

在上述示例中，通过@Async注解表示callAsyncThirdPartyApi方法是异步的，同时使用@Retryable配置了异步方法的重试策略。

5.2 异步方法的降级处理

5.2.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Recover;
import org.springframework.retry.annotation.Retryable;

@Service
public class AsyncThirdPartyService {

    @Async
    @Retryable(
        value = { RestClientException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public CompletableFuture<String> callAsyncThirdPartyApi() {
        // 异步调用第三方API的逻辑
        // ...
    }

    @Recover
    public CompletableFuture<String> fallback() {
        // 异步降级处理逻辑
        // ...
    }
}

在上述示例中，使用@Recover标记的fallback方法同样支持异步，以处理异步方法的降级逻辑。

6 异常分类与重试

在实际应用中，我们可能会遇到不同类型的异常，有些异常是可以通过重试来解决的，而有些异常则需要特殊处理。Spring Retry支持通过include和exclude属性来指定要进行重试的异常类型和要排除的异常类型。

6.1 重试指定类型的异常

6.1.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;

@Service
public class ThirdPartyService {

    @Retryable(
        value = { RestClientException.class, TimeoutException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public String callThirdPartyApi() {
        // 调用第三方API的逻辑
        // ...
    }
}

在上述示例中，callThirdPartyApi方法会在发生RestClientException或TimeoutException异常时进行重试。

6.2 排除指定类型的异常

6.2.1 代码示例

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;

@Service
public class ThirdPartyService {

    @Retryable(
        value = { RestClientException.class },
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2),
        exclude = { TimeoutException.class }
    )
    public String callThirdPartyApi() {
        // 调用第三方API的逻辑
        // ...
    }
}

在上述示例中，callThirdPartyApi方法会在发生RestClientException异常时进行重试，但排除了TimeoutException异常。

7 拓展：使用断路器实现熔断机制

除了重试机制外，熔断机制也是一种常见的容错处理手段。Hystrix是一款流行的断路器实现库，可以与Spring Boot集成，用于实现熔断机制。

7.1 添加依赖

在pom.xml中添加Hystrix的依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>

7.2 配置启用Hystrix

在Spring Boot的主类上添加@EnableHystrix注解：

@SpringBootApplication
@EnableHystrix
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

7.3 使用Hystrix实现熔断

7.3.1 代码示例

import com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;

@Service
public class ThirdPartyService {

    @HystrixCommand(fallbackMethod = "fallback")
    public String callThirdPartyApi() {
        // 调用第三方API的逻辑
        // ...
    }

    public String fallback() {
        // 熔断时的降级逻辑
        // ...
    }
}

在上述示例中，通过@HystrixCommand注解标记了callThirdPartyApi方法，指定了熔断时执行的降级方法fallback。

8 性能分析与测试

在引入重试机制后，我们需要对系统的性能进行全面的测试和分析，以确保重试机制的引入不会影响系统的整体性能。可以通过压力测试工具模拟高并发的情况，观察系统在异常情况下的表现。

9 总结

在Spring Boot项目中，通过集成Spring Retry模块，我们可以优雅地实现对第三方API调用的重试机制。通过@Retryable注解，我们能够很方便地在方法级别上添加重试策略。

同时，异步方法和异常类型的支持使得我们能够更灵活地应对不同的业务场景。此外，我们还介绍了通过断路器（Hystrix）实现熔断机制的拓展方式。

在实际应用中，需要根据业务场景和需求综合考虑重试机制和熔断机制的使用。通过这些容错处理手段，我们能够提高系统的稳定性和可靠性，保障服务的正常运行。

芋道源码 —— 纯源码解析博客

如何在SpringBoot中优雅地重试调用第三方API？