一、核心定位
guava-retrying是基于Google Guava的重试框架，提供灵活的重试策略配置，解决Java项目中"失败重试"的通用场景（如接口调用超时、网络抖动、第三方服务不可用）。
二、核心组件
1. Retryer
重试执行器，通过 `call(Callable<T>)` 方法执行任务，触发重试逻辑。
2. RetryerBuilder
构建Retryer的核心工具，支持链式配置重试规则：
-
重试条件（异常/返回值）；
-
等待策略；
-
停止策略；
-
监听器；
-
超时控制。
3. 核心策略
|------|--------------------------|-----------------|
| 策略类型 | 常用实现 | 适用场景 |
| 等待策略 | FixedWaitStrategy | 内网接口，重试间隔固定 |
| | ExponentialWaitStrategy | 外网/第三方接口，避免高频重试 |
| | RandomWaitStrategy | 分布式场景，打散重试峰值 |
| 停止策略 | StopAfterAttemptStrategy | 按次数停止（最常用） |
| | StopAfterDelayStrategy | 按时长停止（如10秒内重试） |
| | NeverStopStrategy | 无限重试（仅适用于关键任务） |
三、核心API
-
`retryIfException()`：所有RuntimeException重试；
-
`retryIfExceptionOfType(Class<? extends Exception>)`：指定异常重试；
-
`retryIfResult(Predicate<T>)`：基于返回值重试；
-
`withWaitStrategy(WaitStrategy)`：配置等待策略；
-
`withStopStrategy(StopStrategy)`：配置停止策略；
-
`withRetryListener(RetryListener)`：配置监听器；
-
`withAttemptTimeLimiter(AttemptTimeLimiter)`：配置单次任务超时。
四、使用场景
-
第三方接口调用（如支付、短信、物流接口）；
-
分布式锁获取失败；
-
数据库/缓存连接重试；
-
消息队列发送失败重试。