PHP 调第三方接口时，别只看返回内容，超时、HTTP 状态码、cURL 错误要拆开记录。
一、故障现场：curl_exec() 卡住时先看超时配置
后台对接支付、短信、物流接口时，最烦的不是报错，而是请求一直等。页面慢、队列堆、回调重试，看日志只剩一句“接口无响应”。
这类问题先别急着怀疑 PHP 进程。很多时候是远端接口慢，或者连接阶段就耗掉了时间。代码里如果只设置一个总超时，排查起来会很糊。
建议把这几个配置分开写：
· CURLOPT_CONNECTTIMEOUT 控制建立连接的等待时间。
· CURLOPT_TIMEOUT 控制完整请求的总等待时间。
· CURLOPT_RETURNTRANSFER 设为 true，让响应内容返回给变量。
$ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3); curl_setopt($ch, CURLOPT_TIMEOUT, 8); $body = curl_exec($ch);
连接超时可以短一点，总超时按业务动作来定。比如查询物流可以等久点，支付扣款回调就别让一个请求长期占住工作进程。
二、返回判断：curl_exec() 用 === false，别写成 !$body
curl_exec() 失败时返回 false，但接口正常返回空字符串时，$body 也可能看起来像“空”。如果用 if (!$body)，两类问题会被混在一起。
更稳的判断方式是：
$body = curl_exec($ch);
if ($body === false) {
$error = curl_error($ch);
$errno = curl_errno($ch);
}
curl_error() 要在 curl_close() 前读取。关掉句柄后再取错误信息，很容易拿不到有用内容。
这里还要注意一个常见误会：HTTP 返回 404、500，不等于 curl_exec() 执行失败。请求发出去了，服务端也回了响应，cURL 这层可能仍然算成功。
三、状态面板：用 curl_getinfo() 把 http_code 和耗时打出来
只记录响应体不够。接口排障时，最有用的是状态码、耗时、最终 URL。它们能快速判断问题在网络、远端服务、重定向，或业务返回。
可以这样拿信息：
$info = curl_getinfo($ch); $httpCode = $info['http_code'] ?? 0; $totalTime = $info['total_time'] ?? 0;
日志里建议至少带这些字段：
· http_code：判断 200、401、429、500。
· total_time：判断慢在接口整体响应。
· url 或业务接口名：方便按服务商聚合。
· curl_errno：定位 DNS、连接、SSL、超时类问题。
拿到这些数据后，排查会直接很多。比如 http_code 是 429，那就不是 PHP 慢，是触发限流；curl_errno 指向超时，就回到网络和远端响应速度上。
四、上线前：SSL、重试、日志这几项别随手糊过去
接口能跑通只是开始，上线后真正容易出事的是“临时写法”没收回来。比如为了调试把 SSL 验证关了，或者所有失败都自动重试。
我一般按这几条检查：
· HTTPS 接口不要关闭 CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST。
· 重试只给查询、同步状态这类幂等请求，扣款、创建订单这类动作要特别谨慎。
· 请求日志别直接记录完整密钥、签名、手机号这类敏感字段。
· 异常响应要落日志，但页面只返回业务错误，不把远端接口细节抛给用户。
· 接口调用放在后台任务时，要给任务本身也设失败次数和告警阈值。
cURL 代码本身通常不长，难点在边界：执行失败、HTTP 失败、业务失败不是一回事。把这三层分开，后面排障会省很多时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
