必须调用curl_getinfo($ch, CURLINFO_HTTP_CODE)获取HTTP状态码，因curl_exec()仅返回响应体且不反映状态；状态码为0表示网络层失败，需结合curl_errno()和curl_error()诊断。
用 curl_exec() 之前必须调用 curl_getinfo($ch, CURLINFO_HTTP_CODE)
PHP 的 curl_exec() 只返回响应体内容，**不返回状态码**。直接用 if ($res) { ... } 判断是否成功完全不可靠——哪怕服务器返回 500 或 404，只要网络通、响应有内容，curl_exec() 仍可能返回非 false 值。
正确做法是：执行后立刻用 curl_getinfo() 提取状态码：
$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['user' => 'a', 'pass' => 'b']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 关键：必须在这行获取
curl_close($ch);
if ($httpCode === 200) {
// 成功处理 $res
} elseif ($httpCode >= 400) {
// 错误响应，注意：401/403/404/500 都会进这里
}
别依赖 CURLOPT_FAILONERROR 自动失败
这个选项看似省事，但它只对 400–599 状态码触发 curl_exec() 返回 false，而实际开发中你往往需要区分 401（未登录）、403（无权限）、404（接口不存在）等语义——一旦开启 CURLOPT_FAILONERROR，这些状态全被“吞掉”，你拿不到原始响应体和具体状态码。
- 关闭它（默认就是关闭的），自己用
curl_getinfo(..., CURLINFO_HTTP_CODE)判断 - 若需统一拦截错误状态，建议封装成函数，而不是依赖 cURL 自动终止
- 注意：开启后
curl_error($ch)不一定包含 HTTP 状态信息，仅反映传输层错误
POST 失败但状态码是 200？检查 Content-Type 和数据格式
常见陷阱：后端返回 200，但响应体是 {"error":"invalid json"} 或空字符串。这通常不是 cURL 问题，而是请求发错了。
立即学习“PHP免费学习笔记（深入）”；
重点核对：
- 发送 JSON 时，必须显式设置
Content-Type: application/json，且用json_encode()编码数据，再传给CURLOPT_POSTFIELDS - 发送表单数据时，不要手动拼
key=val&key2=val2，优先用http_build_query()防止编码错误 - 某些 API 要求
Content-Type后带; charset=utf-8，少这个可能导致后端解析失败但不报错
超时、DNS失败等场景下 curl_getinfo(..., CURLINFO_HTTP_CODE) 返回 0
状态码为 0 意味着请求根本没发出成功（如域名无法解析、连接超时、SSL 握手失败），此时 curl_error($ch) 和 curl_errno($ch) 才是关键线索。
健壮写法应同时检查：
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($httpCode === 0) {
$errno = curl_errno($ch);
$error = curl_error($ch);
// 例如：$errno === 6 表示无法解析主机名
error_log("cURL error {$errno}: {$error}");
} else {
// 正常处理 HTTP 状态码
}
忽略状态码为 0 的情况，容易把网络故障当成业务失败来处理。
