PHP中curl_setopt致请求超时？本地正常服务器异常排查

你的代码本地运行正常但服务器端超时，结合curl配置，以下是具体排查点和修复建议：

1. 手动设置Content-Length的潜在问题 #

代码中手动计算并设置Content-Length请求头，若服务器环境的字符编码、JSON字符串字节数与本地不一致，会导致服务器等待完整请求数据，最终触发超时。建议删除该请求头，让curl自动处理请求长度。

2. 缺少超时控制配置 #

未设置curl连接和请求超时时间，服务器网络延迟或API响应慢时会触发脚本超时。需添加以下配置：

// 设置连接超时10秒，总请求超时30秒
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

3. 错误捕获与资源泄漏问题 #

代码未捕获curl错误，也未关闭curl句柄，服务器端出问题时无法定位原因，还可能导致资源泄漏。需补充错误处理逻辑：

$result = curl_exec($ch);
// 捕获curl错误
if(curl_errno($ch)){
    echo json_encode(['error' => curl_error($ch)]);
    curl_close($ch);
    exit;
}
// 处理结果后关闭句柄
curl_close($ch);

4. SSL验证的安全隐患（非直接超时原因，但建议修复） #

虽然关闭SSL验证能绕过证书问题，但存在安全风险。若服务器环境允许，建议配置正确的CA证书路径而非直接关闭验证：

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_CAINFO, '/usr/local/share/ca-certificates/cacert.pem'); // 路径根据服务器实际情况调整

修正后的完整代码 #

$id = "dhl";
$number = "039103913";

// 参数配置
$key = 'key';
$secret = 'scret';
$param = array (
    'id' => $id,
    'number' => $number,
    'phone' => '',
    'ship_from' => '',
    'ship_to' => '',
    'area_show' => 1,
    'order' => 'desc'                    
);

// 生成请求JSON与签名
$json = json_encode($param, JSON_UNESCAPED_UNICODE);
$signature = strtoupper(md5($json.$key.$secret));

$url = 'https://www.kd100.com/api/v1/tracking/realtime';

$headers = array (
    'Content-Type:application/json',
    'API-Key:'.$key,
    'signature:'.$signature
);

// 发送POST请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// 添加超时配置
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
// 临时保留SSL关闭配置，建议后续替换为CA证书验证
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

$result = curl_exec($ch);

// 捕获curl错误
if(curl_errno($ch)){
    echo json_encode(['error' => curl_error($ch)]);
    curl_close($ch);
    exit;
}

curl_close($ch);
$data = json_decode($result, true);
echo json_encode($data);

额外排查方向 #

若上述修改后仍超时，需确认服务器网络限制：

• 服务器防火墙是否允许访问目标API的443端口
• 是否需要通过代理访问外部网络，若需代理需添加curl代理配置：

curl_setopt($ch, CURLOPT_PROXY, 'http://your-proxy-ip:port');

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