Hutool HttpUtil自动重试机制如何自定义最大重试次数与间隔时间？

Question

在使用Hutool的HttpUtil进行网络请求时，如何自定义自动重试机制的最大重试次数与间隔时间？默认情况下，HttpUtil并未内置自动重试功能，若需实现自定义重试逻辑，可通过外部包装请求方法，结合循环与异常捕获实现。例如，设置最大重试次数为5次，每次重试间隔2秒，可利用`Thread.sleep(2000)`控制间隔。具体实现中，如何优雅地封装重试逻辑，避免代码冗余，并确保在特定异常（如超时或连接失败）发生时触发重试，是开发者需要重点关注的问题。此外，如何动态调整重试参数以适应不同场景也是一个常见需求。

Answer 1

1. 理解Hutool HttpUtil的默认行为

Hutool 的 HttpUtil 是一个轻量级的 HTTP 请求工具，它提供了简单易用的接口来发送 GET、POST 等请求。然而，默认情况下，HttpUtil 并未内置自动重试机制。这意味着如果请求失败（如超时或连接问题），开发者需要手动处理这些异常并决定是否重试。

以下是使用 HttpUtil 发送 GET 请求的简单示例：

String response = HttpUtil.get("https://example.com/api");
System.out.println(response);
    

在实际应用中，网络请求可能会因为各种原因失败，例如网络波动或服务端不可用。因此，实现自定义的重试逻辑显得尤为重要。

2. 实现基本的重试机制

通过结合循环和异常捕获，可以实现一个简单的重试逻辑。以下是一个设置最大重试次数为 5 次、每次间隔 2 秒的示例：

public String retryHttpGet(String url, int maxRetries, long intervalMillis) {
    int attempt = 0;
    while (attempt < maxRetries) {
        try {
            return HttpUtil.get(url);
        } catch (Exception e) {
            System.out.println("Attempt " + (attempt + 1) + " failed: " + e.getMessage());
            attempt++;
            if (attempt >= maxRetries) {
                throw new RuntimeException("All retries failed", e);
            }
            try {
                Thread.sleep(intervalMillis);
            } catch (InterruptedException ie) {
                Thread.currentThread().interrupt();
            }
        }
    }
    return null; // Should not reach here
}
    

上述代码中，`maxRetries` 和 `intervalMillis` 参数允许动态调整重试次数和间隔时间，以适应不同的场景需求。

3. 封装优雅的重试逻辑

为了减少代码冗余，可以将重试逻辑封装到一个通用工具类中。以下是一个基于泛型的封装示例：

public class RetryUtils {
    public static <T> T executeWithRetry(Supplier<T> action, Predicate<Throwable> retryCondition, 
                                            int maxRetries, long intervalMillis) throws Exception {
        int attempt = 0;
        while (attempt < maxRetries) {
            try {
                return action.get();
            } catch (Throwable t) {
                if (!retryCondition.test(t) || attempt >= maxRetries - 1) {
                    throw t;
                }
                attempt++;
                Thread.sleep(intervalMillis);
            }
        }
        return null; // Should not reach here
    }
}
    

使用此工具类时，可以通过传递 Lambda 表达式和条件来调用：

String result = RetryUtils.executeWithRetry(() -> HttpUtil.get("https://example.com/api"),
    t -> t instanceof IOException, 5, 2000);
    

4. 动态调整重试参数

在某些场景下，可能需要根据具体的业务逻辑动态调整重试参数。例如，对于关键请求可以增加重试次数，而对于非关键请求则减少重试次数以节省资源。以下是一个动态配置的示例：

请求类型	最大重试次数	间隔时间（毫秒）
登录请求	3	1000
支付请求	5	2000
查询请求	2	500

通过配置表或动态参数传递，可以根据不同的请求类型灵活调整重试策略。

5. 流程图展示重试逻辑

以下是重试逻辑的流程图，帮助理解其执行过程：

graph TD;
            A[开始请求] --> B{请求成功？};
            B --是--> C[返回结果];
            B --否--> D{达到最大重试次数？};
            D --是--> E[抛出异常];
            D --否--> F[等待指定间隔];
            F --> G[重试请求];
            G --> B;