php 调接口卡住、偶发失败、线上报证书错误，多数不是接口不稳定，而是 curl 超时、ssl 校验、错误处理没有拆开。生产代码里建议把连接超时、总超时、http 状态码、curl_errno()、响应体解析分开判断，排查会快很多。
PHP cURL 请求卡住：设置 CURLOPT_CONNECTTIMEOUT 和 CURLOPT_TIMEOUT
CURLOPT_CONNECTTIMEOUT 控制连接阶段最多等多久，CURLOPT_TIMEOUT 控制整个请求最多跑多久。接口慢的时候，要先判断耗时集中在连接阶段，或集中在服务端处理和响应下载阶段。
• CURLOPT_CONNECTTIMEOUT 可以设短一点，比如 2 到 5 秒，避免 PHP 进程被网络抖动拖住。
• CURLOPT_TIMEOUT 要按业务场景定，短信、支付、物流查询这类同步接口别给太长。
• 文件上传、报表导出这类请求耗时更长，建议单独配置，不要和普通 JSON 接口共用一套超时。
常见写法是给 $ch 设置 CURLOPT_RETURNTRANSFER、CURLOPT_CONNECTTIMEOUT、CURLOPT_TIMEOUT，再调用 curl_exec()。容易踩的坑是只设置 CURLOPT_TIMEOUT，连接阶段一慢，PHP-FPM worker 依然会被占住。
SSL certificate problem 不要在线上关闭证书校验
看到 SSL certificate problem，很多人会把 CURLOPT_SSL_VERIFYPEER 设成 false。本地临时定位问题可以短暂这么做，线上不建议这样处理，因为 PHP 不再确认对方证书是否可信。
• 正确方向是更新系统 CA 证书，或给 PHP 配好 curl.cainfo。
• 项目单独管理证书时，可以通过 CURLOPT_CAINFO 指向可信 CA 文件。
• 容器环境里要检查镜像内有没有 CA 包，宿主机有证书不代表容器里也有。
如果报错出现 error setting certificate verify locations，重点看 CURLOPT_CAINFO 指向的文件是否存在、PHP 进程是否有读取权限、容器路径是否写错。
curl_exec() 返回 false：区分网络错误和 HTTP 错误
curl_exec() 返回 false，通常是 cURL 传输层失败，比如超时、DNS 失败、SSL 校验失败。接口返回 500、404、429 时，curl_exec() 可能仍然返回响应内容，不能只靠它判断请求成功。
• 用 curl_errno() 判断传输层是否失败。
• 用 curl_error() 记录底层错误信息。
• 用 curl_getinfo() 读取 CURLINFO_HTTP_CODE，再判断接口响应是否可用。
日志里建议保留 errorNo、errorMsg、status、请求地址和耗时。不要把完整 token、手机号、身份证号直接写进日志，排查问题不需要把敏感数据一起暴露。
json_decode() 解析响应：用 JSON_THROW_ON_ERROR 暴露格式问题
接口响应拿到了，不代表数据就能直接用。json_decode() 默认解析失败时可能返回 null，如果业务响应本来允许 null，问题会变得很隐蔽。PHP 7.3 之后可以加 JSON_THROW_ON_ERROR，让 JSON 格式错误直接抛出来。
• 响应体为空时，先判断 $response，再进入 JSON 解析。
• 需要数组时，把 json_decode() 的第二个参数设为 true。
• 大整数 ID 有精度风险时，可以考虑 JSON_BIGINT_AS_STRING。
这套处理看起来比直接请求接口多写了几步，但线上排查会清楚很多。超时、证书、HTTP 状态码、JSON 格式属于不同层的问题，混成一个 请求失败，才是最容易拖慢定位的地方。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
