必须用 curl_error($ch) 和 curl_errno($ch) 获取具体错误，如“Could not resolve host”；配合 curl_getinfo($ch, CURLINFO_HTTP_CODE) 区分网络层（0）与 HTTP 层（400/502）错误。
PHP cURL POST 请求失败时怎么拿到具体错误信息
直接用 curl_error($ch) 和 curl_errno($ch) 才能定位真实问题，光看返回空或 false 没用。cURL 默认不报错，出错了也只返回 false 或空字符串，必须主动查。
常见现象：接口明明通，但 PHP 返回空；或者本地能跑，上线就失败；又或者提示 “Failed to connect to xxx” 却没说明是 DNS、超时还是被拒绝。
- 调用
curl_exec($ch)后立刻检查curl_errno($ch)是否非 0 - 如果是 0，再看返回值是否为 false（比如 CURLOPT_RETURNTRANSFER 设为 false 时）
- 用
curl_error($ch)获取人类可读的错误描述，例如"Could not resolve host: api.example.com" - 配合
curl_getinfo($ch, CURLINFO_HTTP_CODE)区分是网络层失败（如 0）还是 HTTP 层失败（如 400/502）
file_get_contents + stream_context_create 模拟 POST 时如何捕获异常
这个组合看着简单，但错误处理比 cURL 更隐蔽——它默认不抛异常，出错时只返回 false，且不会暴露底层 socket 错误。必须手动开启异常开关并捕获 Warning 级错误。
- 在调用前加
set_error_handler()捕获file_get_contents(): failed to open stream类警告 - 或改用
try/catch包裹，但前提是把stream_context_create()中的ignore_errors设为 true，并检查返回的$http_response_header -
http_response_header数组里可能含"HTTP/1.1 500 Internal Server Error"，但注意它只在成功建立连接后才存在 - 如果连 DNS 都解析失败，
file_get_contents直接返回 false，且无任何 header 或 error 可查，此时只能靠gethostbyname()预检
POST 数据编码错误导致 400 或空响应的排查点
不是所有“请求失败”都是网络问题。Content-Type 和数据格式不匹配，服务端直接拒收，返回 400 或静默丢弃，看起来就像超时或空响应。
立即学习“PHP免费学习笔记（深入）”；
- 发 JSON：必须设
Content-Type: application/json，且用json_encode()编码，不能直接传数组 - 发表单：用
http_build_query($data)，别手拼字符串；同时确认Content-Type是application/x-www-form-urlencoded - 传文件：要用
CURLOPT_POSTFIELDS数组形式（['file' => new CURLFile('/path')]），别用@/path旧语法（PHP 8 已废弃） - 中文或特殊字符：确保源数据是 UTF-8，必要时用
mb_convert_encoding()转码，否则服务端解码失败可能返回 400
超时、重试与连接复用对错误判断的影响
设置不当的超时和重试逻辑，会让错误信息失真。比如把 CURLOPT_TIMEOUT 设太短，本该是服务端慢，却报 “Operation timed out”；又或者开了自动重试，掩盖了首次真实的 502 错误。
-
CURLOPT_TIMEOUT控制整个请求生命周期，CURLOPT_CONNECTTIMEOUT只管建连阶段，两者要分开设（如连通 5s，总耗时 30s） - 禁用自动重试：
curl_setopt($ch, CURLOPT_FRESH_CONNECT, true)，避免 cURL 内部重试干扰错误码 - 连接复用（keep-alive）默认开启，但某些代理或老旧服务端不支持，可加
Connection: close头临时规避 - 生产环境建议记录
CURLINFO_TOTAL_TIME和CURLINFO_PRETRANSFER_TIME，区分是卡在 DNS、TLS 还是服务端响应
最常被忽略的是：错误类型决定处理方式。网络层错误（如 7、6、28）该重试或换节点；HTTP 层错误（如 401、422）不该重试，而应检查参数或鉴权；服务端错误（5xx）要看是否可降级。不分类，就容易把 token 过期当网络抖动来重试。
