如何在PHP cURL中捕获504错误并提示前端？

当cURL请求遇到504网关超时，若服务器未返回完整HTTP响应，curl_getinfo($curl, CURLINFO_HTTP_CODE)确实无法获取到状态码。这种情况下需要结合cURL的错误码与响应状态码双重判断，同时调整超时配置覆盖不同场景的超时情况，最终给前端返回可识别的超时标识。

具体解决方案 #

1. 细化超时配置 #

区分连接超时（建立TCP连接的耗时上限）和总请求超时（整个请求的最长耗时），避免单一超时设置覆盖不全：

• CURLOPT_CONNECTTIMEOUT：设置连接阶段的超时时间（单位：秒）
• CURLOPT_TIMEOUT：设置整个请求的总超时时间（单位：秒，原配置的60000秒不合理，建议调整为业务允许的合理值）

2. 双重判断超时场景 #

执行请求后，先通过curl_errno()判断cURL自身的超时错误，再配合curl_getinfo捕获服务器返回的504状态码，覆盖两种超时情况：

• CURLE_OPERATION_TIMEDOUT（错误码28）：cURL自身检测到的超时（连接超时/请求超时）
• 状态码504：服务器明确返回的网关超时

修改后的完整代码示例 #

// 初始化cURL资源
$curl = curl_init();

// 配置cURL参数，优化超时设置
curl_setopt_array($curl, array(
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_CONNECTTIMEOUT => 30, // 连接超时30秒
    CURLOPT_TIMEOUT => 60, // 总请求超时60秒
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_USERAGENT => $userAgent,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => $payload,
    CURLINFO_HEADER_OUT => true,
    CURLOPT_HTTPHEADER => array(
        'Content-Type: application/json',
        'Authorization: Basic xxx'
    ),
));

// 执行请求
$response = curl_exec($curl);

// 获取cURL错误码和HTTP状态码
$curlErrno = curl_errno($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// 关闭cURL资源
curl_close($curl);

// 判断是否为超时场景
$isTimeout = false;
if ($curlErrno == CURLE_OPERATION_TIMEDOUT) {
    $isTimeout = true;
} elseif ($httpCode == 504) {
    $isTimeout = true;
}

// 返回前端响应
header('Content-Type: application/json');
if ($isTimeout) {
    // 返回超时标识，前端可据此弹出UI提示
    echo json_encode([
        'status' => 'error',
        'msg' => '请求超时，请稍后重试'
    ]);
} else {
    // 返回正常响应内容
    echo $response;
}

关键说明 #

• 前端只需监听后端返回的status字段，即可在UI层触发超时提示，无需依赖控制台错误信息
• 合理设置超时时间可避免无效的长时等待，提升用户体验

内容的提问来源于stack exchange，提问作者Ping