PHP(cURL)调用API时curl_exec()触发最大执行时间致命错误的解决方法

我之前也碰到过一模一样的问题，折腾了好一阵才搞定，给你几个实用的解决方案，按优先级排序：

1. 优先检查并设置cURL自身的超时参数 #

很多时候不是PHP的全局执行时间限制，而是cURL没有设置合理的超时，导致请求一直挂着直到触发PHP的max_execution_time。一定要给cURL设置两个关键超时：

• CURLOPT_CONNECTTIMEOUT：连接到服务器的超时时间（秒），比如设10秒，避免卡在连接阶段
• CURLOPT_TIMEOUT：整个请求的总超时时间（秒），比如设60秒，控制整个请求的最长耗时

如果你的PHP版本在7.1以上，还可以用CURLOPT_TIMEOUT_MS设置毫秒级超时（比如60000表示60秒），更精准。

示例代码：

$ch = curl_init('https://your-api-endpoint.com');

// 连接超时10秒
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
// 总请求超时60秒
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
// 可选：毫秒级超时（PHP 7.1+）
// curl_setopt($ch, CURLOPT_TIMEOUT_MS, 60000);

// 其他必要配置
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); // 如果API有重定向
curl_setopt($ch, CURLOPT_MAXREDIRS, 5); // 限制最大重定向次数，避免死循环

$response = curl_exec($ch);

// 检查cURL错误
if (curl_errno($ch)) {
    die('cURL请求失败：' . curl_error($ch));
}

curl_close($ch);

2. 调整PHP的执行时间限制 #

如果cURL的超时已经设置合理，但API确实需要更长时间处理（比如大文件上传/下载），可以临时调整PHP的执行时间：

方法1：在脚本中动态设置 #

在请求代码的最开头添加：

// 设置为300秒（5分钟），0表示无限制（web环境不建议用0）
ini_set('max_execution_time', 300);

注意：如果服务器开启了safe_mode，这个设置会失效，需要改php.ini。

方法2：修改php.ini配置 #

找到php.ini中的max_execution_time项，修改为合适的值，比如：

max_execution_time = 300

修改后需要重启web服务器（Apache/Nginx）生效。

⚠️ 注意：CLI模式下PHP的max_execution_time默认是0（无限制），所以如果是命令行脚本，不用改这个。

3. 分块处理请求（API支持的话） #

如果你的请求是拉取大量数据或者处理批量任务，试试把大请求拆分成多个小请求，比如分页调用API：

示例代码（假设API支持分页参数）：

$page = 1;
$perPage = 100;
$hasMore = true;

while ($hasMore) {
    $ch = curl_init("https://your-api-endpoint.com/data?page=$page&per_page=$perPage");
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    $data = json_decode($response, true);
    
    // 处理当前页的数据
    $this->processBatchData($data['items']);
    
    // 检查是否还有下一页
    $hasMore = !empty($data['meta']['next_page']);
    $page++;
    
    curl_close($ch);
}

这样每个小请求的耗时都在超时范围内，不会触发全局执行时间限制。

4. 排查API响应慢的根本原因 #

有时候超时是因为API本身响应慢，或者网络问题，你可以用curl_getinfo()查看请求的各个阶段耗时，针对性优化：

$ch = curl_init('https://your-api-endpoint.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

// 获取请求详情
$info = curl_getinfo($ch);
echo "总耗时：" . $info['total_time'] . "秒\n";
echo "连接服务器耗时：" . $info['connect_time'] . "秒\n";
echo "DNS解析耗时：" . $info['namelookup_time'] . "秒\n";
echo "数据传输耗时：" . ($info['total_time'] - $info['connect_time']) . "秒\n";

curl_close($ch);

如果DNS解析慢，可以手动指定DNS服务器；如果传输慢，试试开启cURL的压缩：

curl_setopt($ch, CURLOPT_ENCODING, 'gzip, deflate');

5. 异步处理请求（业务允许的话） #

如果你的业务不需要同步等待API响应，把请求放到后台异步处理是最好的方案，比如：

方法1：用shell_exec启动后台脚本 #

创建一个单独的脚本api_background_task.php，里面写你的cURL请求代码，然后在主脚本中执行：

// 启动后台进程，主脚本立即返回
exec('php api_background_task.php > /dev/null 2>&1 &');

注意：>/dev/null 2>&1 &是把输出重定向到空，让进程在后台运行，不阻塞主脚本。

方法2：用消息队列（适合复杂场景） #

如果是大型项目，可以用Redis、RabbitMQ等消息队列，把API请求任务放到队列里，然后用Worker进程异步处理，这样既不会触发超时，还能实现任务重试、监控等功能。

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