curl_multi_select 返回零怎么配置或排查

在 PHP 的并行 cURL 循环里，curl_multi_select() 返回零通常不是请求失败，而是等待的 timeout 已到、当前没有描述符活动。真正需要优先区分的是：正数代表有描述符可推进，0 代表这次没有活动，-1 才表示底层 select 失败。把三种结果混在一起，最容易造成忙等、CPU 飙高，或者把正常等待误记成网络错误。

官方文档：https://www.php.net/manual/en/function.curl-multi-select.php

先分清返回 0、-1 和正常完成

curl_multi_select($mh, $timeout) 等待的是“下次调用 curl_multi_exec() 可以继续推进”的时机。返回正数表示描述符集合里有活动；返回 0 表示 timeout 到期但没有描述符活动，这并不等于 HTTP 错误，也不能用 curl_errno() 去判断它。返回 -1 才是底层 select 失败，常见于没有可监控的文件描述符、运行环境差异或 libcurl 的 socket 状态暂时无法交给 select。

所以排查时先记录三项：$running 是否仍大于零、select 的返回值、以及多句柄错误码。只要 $running 已经为零，就应该离开等待循环，转去读取完成结果，而不是继续调用 select。

正确的多句柄循环怎么组织

稳定的结构是“执行一次、读取完成消息、仍在运行才等待”。下面的示例只展示控制边界，URL 和响应内容仍应由业务代码自行处理。代码里的中文注释说明了为什么要把判断放在这些位置。

 0) {
        // 0 只表示本次等待无活动；timeout 不能写成负数。
        $descriptors = curl_multi_select($mh, 1.0);
        if ($descriptors === -1) {
            // 记录 multi 层错误；短暂退避避免失败环境下忙等。
            usleep(1000);
            $multiError = curl_multi_errno($mh);
            if ($multiError !== 0) {
                error_log(curl_multi_strerror($multiError));
            }
        } elseif ($descriptors === 0) {
            // 没有 socket 活动时让出一点 CPU，再回到 exec 推进状态。
            usleep(1000);
        }
    }
} while ($running > 0);

// 所有句柄都完成后再关闭 multi handle。
curl_multi_close($mh);
?>

这里不能只写 while (curl_multi_select($mh) === 0) 来等待。0 代表一次等待没有事件，下一步仍应回到 curl_multi_exec()；把 select 自己套成忙循环，反而会让状态推进和完成消息处理失去明确边界。

返回零时怎么配置和排查

第一步看 timeout。它是秒数，默认值为 1.0；用 0 会立即返回，适合主动轮询但更容易空转。通常先用一个有限的小数或默认值，让等待有机会阻塞；如果业务还有自己的总超时，应在外层记录开始时间，不能靠无限增大单次 timeout 代替总超时。

第二步看是否连续返回零。偶发一次很正常，连续多次则说明这段时间没有可读写的描述符，或当前环境的 socket 状态不适合被 select 监控。保留 usleep(1000) 这类短退避，并继续调用 curl_multi_exec()，比固定长睡眠更不容易拖慢所有请求。

第三步区分多句柄错误和单句柄错误。curl_multi_exec() 的 CURLM_OK 只说明 multi 栈本身没有整体错误；单个传输要遍历 curl_multi_info_read()，查看消息中的 result。不要因为 select 返回零就读取一个不存在的 HTTP 状态码。

版本差异和最后一份检查清单

如果项目支持 PHP 8.4 及以上，还要确认 timeout 没有小于 0 或大于 PHP_INT_MAX，否则函数会抛出 ValueError。老项目则要注意 PHP 与 libcurl 组合的行为差异：不要照搬多年前把所有 -1 都静默吞掉的代码，至少先留下 curl_multi_errno() 和运行环境信息。

最后复查四点：exec 是否在 select 前后都被正确调用；info_read 是否读到 false 才停止；完成句柄是否 remove 和 close；外层是否有总超时与可观测日志。这样“返回零”就从一个模糊报错，变成可定位的等待状态。

常见问题

curl_multi_select 返回 0 是不是网络断开？

不是。它只表示本次等待窗口内没有描述符活动，网络错误要看完成消息里的 result 或整体 multi 错误。

返回 -1 时应该一直重试 select 吗？

不要原地高速重试。先用 curl_multi_errno() 记录错误，短暂退避，再回到 curl_multi_exec()；若持续发生，应检查 PHP、libcurl 和运行环境。

为什么 running 已经为 0 还要读取 info_read？

running 表示仍在进行的传输数量，完成消息可能还在队列里；退出前把消息读完，才能取得每个句柄的最终结果。