快捷導(dǎo)航

Java實現(xiàn)第三方 HTTP 接口重試實現(xiàn)方式

更新時間：2026年02月09日 09:47:38 作者：思靜魚

本文主要介紹了Java實現(xiàn)第三方 HTTP 接口重試實現(xiàn)方式,包括手寫循環(huán)重試、使用SpringRetry、Feign+Resilience4j、GuavaRetryer和MQ延遲重試,文中通過示例代碼介紹的非常詳細(xì),需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

1. 手寫循環(huán)重試（最簡單）

直接用 for 循環(huán) + try/catch 來控制：

public String callThirdPartyApi(String url) {
    int maxRetries = 3; // 最大重試次數(shù)
    int retryDelay = 2000; // 毫秒
    for (int i = 1; i <= maxRetries; i++) {
        try {
            HttpResponse<String> response = Unirest.get(url).asString();
            if (response.getStatus() == 200) {
                return response.getBody();
            }
        } catch (Exception e) {
            System.err.println("第 " + i + " 次調(diào)用失敗: " + e.getMessage());
        }
        try {
            Thread.sleep(retryDelay); // 間隔
        } catch (InterruptedException ignored) {}
    }
    throw new RuntimeException("調(diào)用接口失敗，已重試 " + maxRetries + " 次");
}

簡單易懂
不支持指數(shù)退避、異常分類，適合小項目

2. 使用 Spring Retry（推薦）

Spring 提供的 注解驅(qū)動重試，非常適合調(diào)用第三方接口：

@Service
public class ThirdPartyApiService {

    @Retryable(
        value = {SocketTimeoutException.class, IOException.class}, // 哪些異常可重試
        maxAttempts = 3,  // 最大重試次數(shù)
        backoff = @Backoff(delay = 2000, multiplier = 2) // 2s, 4s, 8s
    )
    public String callApi(String url) {
        RestTemplate restTemplate = new RestTemplate();
        return restTemplate.getForObject(url, String.class);
    }

    // 超過最大重試次數(shù)后的兜底邏輯
    @Recover
    public String recover(Exception e, String url) {
        System.err.println("接口調(diào)用失敗，進(jìn)入降級邏輯: " + e.getMessage());
        return "fallback";
    }
}

特點(diǎn)：支持 注解 + 指數(shù)退避 + 異常分類 + 兜底邏輯
依賴 spring-retry 和 spring-aspects

3. 使用 Feign + Resilience4j

如果你用的是 Spring Cloud / OpenFeign，可以加上 Resilience4j Retry：

@FeignClient(name = "thirdPartyApi", url = "https://api.example.com", configuration = RetryConfig.class)
public interface ThirdPartyClient {
    @GetMapping("/data")
    String getData();
}

配置 Resilience4j Retry：

resilience4j.retry:
  instances:
    thirdPartyRetry:
      maxAttempts: 3
      waitDuration: 2s
      enableExponentialBackoff: true
      exponentialBackoffMultiplier: 2

特點(diǎn)：適合微服務(wù)架構(gòu)，支持 熔斷、限流、重試 一體化
配置稍微復(fù)雜

4. 使用 Guava Retryer（靈活、輕量）

Google Guava 提供 Retryer，適合單獨(dú)使用：

Retryer<String> retryer = RetryerBuilder.<String>newBuilder()
        .retryIfExceptionOfType(IOException.class) // 遇到 IOException 重試
        .retryIfResult(Objects::isNull) // 返回結(jié)果為空也重試
        .withWaitStrategy(WaitStrategies.exponentialWait(2, 10, TimeUnit.SECONDS)) // 指數(shù)退避
        .withStopStrategy(StopStrategies.stopAfterAttempt(3)) // 最多 3 次
        .build();

public String callThirdPartyApi(String url) {
    try {
        return retryer.call(() -> {
            HttpResponse<String> response = Unirest.get(url).asString();
            if (response.getStatus() != 200) {
                throw new IOException("HTTP " + response.getStatus());
            }
            return response.getBody();
        });
    } catch (Exception e) {
        throw new RuntimeException("調(diào)用失敗", e);
    }
}

特點(diǎn)：輕量靈活，支持復(fù)雜策略（比如隨機(jī)抖動）
需要額外依賴 Guava Retryer