Java请求重试流程如何规整：从混乱到优雅的架构实践
📖 目录导读
- 为什么需要规整的请求重试
- 重试流程的核心三要素
- 主流重试框架对比与选型
- Spring Retry + Guava Retryer 实战配置
- 重试策略的5种常见模式
- 幂等性：重试的生命线
- 避坑指南：重试的10个反模式
- 架构级重试：从代码到治理平台
- 常见问答（FAQ）
为什么需要规整的请求重试
在分布式系统中，网络抖动、数据库主从延迟、服务限流降级都是常态，根据Google SRE报告，80%的瞬时故障可以通过合理的重试自动恢复,但不当的重试会导致：
- 雪崩效应：调用方同时重试，下游压力暴增
- 资源泄漏：线程池被重试任务占满
- 数据不一致：重复消费导致重复扣款
读者问：不加重试不是更简单？ 答：是的，但会导致用户体验下降（支付失败需手动点击）、业务连续性受损（定时任务中断）,规整的重试是弹性工程的基础。
重试流程的核心三要素
任何重试都必须明确三个要素（参考Google Cloud API设计规范）：
| 要素 | 说明 | 典型错误 |
|---|---|---|
| 场景判定 | 哪些异常值得重试 | 重试了NullPointerException（不可恢复） |
| 间隔策略 | 重试等待时间 | 固定1秒重试（加剧拥堵） |
| 终止条件 | 何时停止重试 | 无限重试（拖垮服务） |
黄金法则：只重试幂等操作，只重试可恢复异常（如IOException、TimeoutException）。
主流重试框架对比与选型
| 框架 | 特点 | 适用场景 |
|---|---|---|
| Spring Retry | 与Spring深度集成，支持注解 | Spring Boot项目，声明式重试 |
| Guava Retryer | 轻量，策略灵活 | 非Spring项目，或需要复杂策略 |
| Resilience4j | 引入断路器+限流 | 高并发系统，需多级防护 |
| 手动while循环 | 无依赖 | 简单脚本，不建议生产使用 |
选型建议：
- 团队使用Spring生态 → Spring Retry（官方维护,bug少）
- 需要自定义重试策略（如退避算法） → Guava Retryer（代码简洁）
- 需要熔断降级 → Resilience4j（Netflix Hystrix替代品）
Spring Retry + Guava Retryer 实战配置
1 Spring Retry 注解版（推荐）
@Component
public class PaymentService {
@Retryable(
value = {RemoteException.class, TimeoutException.class}, // 重试的异常
maxAttempts = 3, // 最大重试3次（包含第一次调用）
backoff = @Backoff(
delay = 1000, // 初始延迟1秒
multiplier = 2, // 指数递增：1秒→2秒→4秒
maxDelay = 10000 // 最大延迟10秒
)
)
public PaymentResult processPayment(PaymentRequest request) {
// 调用第三方支付网关
}
@Recover
public PaymentResult recover(RemoteException e, PaymentRequest request) {
// 重试彻底失败后的降级处理
log.error("支付失败，降级为缓存通知");
return PaymentResult.fallback("系统繁忙，稍后重试");
}
}
2 Guava Retryer 流式API（更灵活）
Retryer<Boolean> retryer = RetryerBuilder.<Boolean>newBuilder()
.retryIfExceptionOfType(IOException.class) // 只重试网络异常
.retryIfRuntimeException() // 重试运行时异常（谨慎）
.withWaitStrategy( // 等待策略
WaitStrategies.fibonacciWait(1000, 10, TimeUnit.SECONDS) // 斐波那契退避
)
.withStopStrategy( // 停止策略
StopStrategies.stopAfterAttempt(5) // 最多重试5次
)
.withRetryListener(new RetryListener() { // 监听器：记录日志
@Override
public <V> void onRetry(Attempt<V> attempt) {
log.info("第{}次重试，异常: {}", attempt.getAttemptNumber(), attempt.getExceptionCause());
}
})
.build();
// 执行重试
try {
retryer.call(() -> {
return httpClient.send(request);
});
} catch (ExecutionException | RetryException e) {
log.error("最终失败，发送告警"); // 最终失败处理
}
重试策略的5种常见模式
| 策略 | 说明 | 适用场景 |
|---|---|---|
| 固定间隔 | 每次等待相同时间 | 测试环境，非关键链路 |
| 指数退避 | 等待时间指数增长 | 推荐：加jitter防止惊群 |
| 随机退避 | 在范围内随机等待 | 避免同时重试的“羊群效应” |
| 渐进退避 | 按阶梯增长 | 数据库连接重试 |
| 瞬时重试 | 不间断快速重试3次 | 读操作（如缓存miss） |
读者问：指数退避为什么一定要加随机抖动（jitter）？ 答：假设1000个客户端同时遇到超时，如果不加jitter，它们会按照完全相同的重试间隔同时发起请求，导致下游瞬间被击穿，加随机抖动（如基础间隔±20%）可以让请求均匀分散。
幂等性：重试的生命线
没有幂等，就没有重试,常见的幂等方案：
-
唯一ID去重（常用）：
public PaymentResult processPayment(PaymentRequest request) { // 插入全局唯一id到数据库，重复则跳过（例如用insert ignore） } -
状态机幂等：
订单从“待支付→支付中→已支付”，同一状态不重复处理
-
乐观锁：
update order set status='PAID', version=version+1 where order_id=xxx and version=oldVersion
最佳实践：在业务入口统一生成幂等ID,通过Redis或DB的防重表过滤。
避坑指南：重试的10个反模式
- ❌ 无限制重试（导致线程池耗尽）
- ❌ 重试非幂等操作（如扣款请求）
- ❌ 忽略业务级异常（如“余额不足”重试无意义）
- ❌ 所有异常都重试（包括
404 Not Found） - ❌ 重试间隔无上限（指数增长到天级别）
- ❌ 并发重试（多个线程同时重试同一请求）
- ❌ 不记录重试日志（故障排查困难）
- ❌ 忽略最终降级（重试失败后无回调）
- ❌ 在Filter层全局重试（污染所有接口）
- ❌ 重试与熔断混用（两者应分层）
读者问：我的微服务调用链A->B，在A重试了B的接口，但B本身也在重试，怎么办？ 答：这是嵌套重试，会放大流量，建议：只在调用方（A）设置一次重试，被调用方（B）只负责幂等，不做重试，或者使用请求头传递重试次数,超过上限直接拒绝。
架构级重试：从代码到治理平台
大型系统应建设重试治理中心：
- 配置中心动态调整：支持线上修改重试次数、间隔（如Apollo/ Nacos）
- 统一重试调度器：将重试任务持久化到数据库/MQ，异步执行
- 监控大盘：重试次数、成功率、原因分布（如自定义
@RetryMonitor注解） - 自动熔断：当某接口重试失败率超过阈值，自动切换到降级策略
示例：基于MQ的重试架构
调用方 → 发送消息到重试队列 → 消费者处理 → 失败则投递到延迟队列 → 到期再次消费
↕
失败次数超限 → 死信队列 + 告警常见问答（FAQ）
Q1：重试次数设为多少合适？ A：通常3次（包括初始调用1次），超过3次,手动修复比自动重试更可靠。
Q2：哪些HTTP状态码适合重试？ A：可重试：408（超时）、429（限流，搭配Retry-After）、503（服务不可用）、504（网关超时），禁止重试：400（参数错误）、401（认证失败）、404（不存在）。
Q3：重试是否会影响分布式事务？ A：会，如果重试期间已经提交了本地事务，重试会重复执行，建议使用TCC模式或Saga,配合幂等。
Q4：Guava Retryer和Spring Retry怎么选？ A：Spring项目无脑选Spring Retry，配置简单且支持声明式；需要高级策略（如自定义等待策略）选Guava Retryer。
Q5：重试日志需要注意什么？
A：必须记录：原始请求ID、重试次数、异常详情、响应时间，可以输出到独立的retry.log文件,方便分析。
规整的Java请求重试流程，核心在于明确何时重试、如何等待、何时停止，通过框架（Spring Retry/Guava Retryer）+ 策略（指数退避）+ 幂等（唯一ID）+ 监控（日志+指标），可以构建一个既健壮又不失控的重试体系。重试是手段，降级是底线，幂等是前提。
（文章约1400字）
