Java实现第三方 HTTP 接口重试实现方式
作者:思静鱼
本文主要介绍了Java实现第三方 HTTP 接口重试实现方式,包括手写循环重试、使用SpringRetry、Feign+Resilience4j、GuavaRetryer和MQ延迟重试,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
第三方 HTTP 接口重试的编码实现方式,这类场景在 Java 里非常常见,比如:
- 订单系统调用第三方支付接口
- 网关调用外部认证服务
- Java 服务调用算法 HTTP 服务
1. 手写循环重试(最简单)
直接用 for 循环 + try/catch 来控制:
public String callThirdPartyApi(String url) {
int maxRetries = 3; // 最大重试次数
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 + " 次调用失败: " + e.getMessage());
}
try {
Thread.sleep(retryDelay); // 间隔
} catch (InterruptedException ignored) {}
}
throw new RuntimeException("调用接口失败,已重试 " + maxRetries + " 次");
}
简单易懂
不支持指数退避、异常分类,适合小项目
2. 使用 Spring Retry(推荐)
Spring 提供的 注解驱动重试,非常适合调用第三方接口:
@Service
public class ThirdPartyApiService {
@Retryable(
value = {SocketTimeoutException.class, IOException.class}, // 哪些异常可重试
maxAttempts = 3, // 最大重试次数
backoff = @Backoff(delay = 2000, multiplier = 2) // 2s, 4s, 8s
)
public String callApi(String url) {
RestTemplate restTemplate = new RestTemplate();
return restTemplate.getForObject(url, String.class);
}
// 超过最大重试次数后的兜底逻辑
@Recover
public String recover(Exception e, String url) {
System.err.println("接口调用失败,进入降级逻辑: " + e.getMessage());
return "fallback";
}
}
特点:支持 注解 + 指数退避 + 异常分类 + 兜底逻辑
依赖 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
特点:适合微服务架构,支持 熔断、限流、重试 一体化
配置稍微复杂
4. 使用 Guava Retryer(灵活、轻量)
Google Guava 提供 Retryer,适合单独使用:
Retryer<String> retryer = RetryerBuilder.<String>newBuilder()
.retryIfExceptionOfType(IOException.class) // 遇到 IOException 重试
.retryIfResult(Objects::isNull) // 返回结果为空也重试
.withWaitStrategy(WaitStrategies.exponentialWait(2, 10, TimeUnit.SECONDS)) // 指数退避
.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("调用失败", e);
}
}
特点:轻量灵活,支持复杂策略(比如随机抖动)
需要额外依赖 Guava Retryer
5. 高级:MQ + 延迟重试(分布式场景)
如果第三方接口经常不稳定,可以采用 消息队列延迟重试:
- 请求失败 → 写入 MQ 延迟队列(如 RabbitMQ TTL、Kafka 延时消息)
- 延迟 N 秒后再消费,进行重试
- 超过最大次数 → 死信队列(DLQ),人工处理
特点:解耦、可观测、适合高并发分布式系统
引入 MQ,复杂度更高
总结
第三方 HTTP 接口重试实现方式有:
- 手写 for 循环(简单粗暴)
- Spring Retry(主流、优雅,推荐)
- Feign + Resilience4j(适合微服务)
- Guava Retryer(灵活轻量)
- MQ 延迟重试(分布式 & 高可靠场景)
建议:业务系统用 Spring Retry / Resilience4j,跨系统对接用 MQ 延迟重试兜底。
到此这篇关于Java实现第三方 HTTP 接口重试实现方式的文章就介绍到这了,更多相关Java 第三方HTTP接口重试内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
