首先明确答案，本文介绍如何使用 php-curl 实现带重试次数、间隔控制及失败回调的接口请求机制。设定最大重试次数和微秒级延迟，通过 for 循环结合 usleep 实现等待；利用 curl_error 和 curl_errno 判断连接超时、5xx 错误等可重试异常，避免对 400 类错误重复请求；封装函数支持传入 onFailure 回调，在最终失败后记录日志或告警；示例展示了请求三次并在失败时输出错误信息。该方案提升系统容错性，关键在于精准区分错误类型以避免无效重试。
设定最大重试次数与重试间隔
在发起请求前，应明确最大重试次数和每次重试之间的等待时间，避免无限重试或高频请求压垮服务端。
可通过循环结合 sleep() 或 usleep() 控制重试延迟。例如设置最多重试 3 次，每次间隔 1 秒：
- 定义
$maxRetries = 3和$delay = 1000000（单位微秒） - 使用
for循环尝试请求，失败后调用usleep($delay) - 每次重试递增计数，达到上限后退出并触发失败逻辑
基于 curl 的请求封装与错误判断
使用 cURL 发起请求时，需正确识别可重试的错误类型，如超时、连接失败等，而非 400 类客户端错误。
关键检查点包括：
立即学习“PHP免费学习笔记（深入）”；
-
curl_error($ch)是否返回非空字符串 -
curl_errno($ch)判断错误码，常见可重试错误有 CURLE_COULDNT_CONNECT、CURLE_OPERATION_TIMEOUTED、CURLE_SEND_ERROR 等 - HTTP 状态码是否为 5xx 或网关类错误（如 502、503）
只有在这些条件下才执行重试，避免对参数错误等无效请求重复发送。
实现失败回调以记录日志或报警
当所有重试尝试均失败后，应触发回调函数进行后续处理，如记录错误日志、发送告警通知或写入消息队列。
可将回调函数作为参数传入请求方法，例如：
function httpRequestWithRetry($url, $maxRetries = 3, $onFailure = null) {
$ch = curl_init();
// 设置 cURL 参数
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
for ($i = 0; $i <= $maxRetries; $i++) {
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
if (!$error && $response !== false && $httpCode >= 200 && $httpCode < 300) {
curl_close($ch);
return ['success' => true, 'data' => $response];
}
// 判断是否需要重试
if ($i < $maxRetries && in_array(curl_errno($ch), [CURLE_COULDNT_CONNECT, CURLE_OPERATION_TIMEOUTED])) {
usleep(1000000); // 等待 1 秒
continue;
}
// 所有重试失败，触发回调
if ($onFailure && is_callable($onFailure)) {
$onFailure([
'url' => $url,
'http_code' => $httpCode,
'error' => $error,
'retry_count' => $i
]);
}
break;
}
curl_close($ch);
return ['success' => false, 'error' => 'Request failed after retries'];
}
实际调用示例
使用上述函数并传入失败回调：
httpRequestWithRetry(
'https://api.example.com/data',
3,
function($log) {
error_log("API 请求失败: {$log['url']}，状态码: {$log['http_code']}，错误: {$log['error']}");
// 可扩展：发送邮件、写数据库、推送至监控系统
}
);
基本上就这些。合理设置重试策略能显著提升接口调用成功率，同时配合回调机制保障异常可追踪。不复杂但容易忽略的是区分可重试与不可重试错误，避免无效重试拖慢系统响应。
