PHP curl_multi_select 返回 -1 时怎样避免多请求循环空转

在 PHP 的 cURL 多请求循环里，curl_multi_select() 返回 -1 时，不要把它当成“有活动”立即无间隔重试。更稳妥的做法是：继续让 curl_multi_exec() 推进状态，只在 -1 分支加入一个很短的 usleep()，再回到执行循环。这样既不会丢掉请求状态，也能避免没有可监视描述符时 CPU 空转。

curl_multi_select 的返回值到底表示什么

curl_multi_select($multi_handle, $timeout) 会等待某个已加入的 cURL 连接可以继续推进，或者等到 timeout 到期。官方手册给出的返回语义是：返回活动描述符数量时说明有连接可推进；返回 0 表示这段等待时间内没有活动；返回 -1 表示底层 select() 失败。

因此，0 和 -1 不能混为一谈。0 是一次正常的“等待结束但没有新活动”，应继续回到执行循环；-1 则说明当前没有可靠的描述符等待结果，直接紧密重试容易把循环变成忙等。

先用 curl_multi_exec 推进请求状态

多请求循环的核心状态是 $stillRunning。每次调用 curl_multi_exec() 后，都要根据它判断是否还有传输没有结束；某些 PHP 与 libcurl 组合还需要处理 CURLM_CALL_MULTI_PERFORM，避免在状态尚未稳定时过早进入等待。

这里的函数只封装状态推进，不把等待策略和结果读取混在一起。这样后面的 -1 处理有清晰的落点，也更容易区分 cURL 返回码与 PHP 异常。

只给 -1 分支加入短暂等待

当 curl_multi_select() 返回 -1 时，循环仍然需要继续推进，因为它不代表所有传输都失败；它只说明这次 select 没能提供可等待的描述符。关键是加入一个有限的退让时间，让下一次状态推进不会在同一个时间片里反复占用 CPU。

 0) {
        // timeout 用有限值，避免一次等待无限挂起。
        $ready = curl_multi_select($multi, 1.0);
        if ($ready === -1) {
            // 没有可监视描述符时短暂退让，避免 -1 触发忙等。
            usleep(100000);
        }

        // select 返回 0 或正数都回到同一个状态推进入口。
        $code = execMulti($multi, $stillRunning);
        if ($code !== CURLM_OK) {
            throw new RuntimeException('curl_multi_exec failed: ' . $code);
        }
    }
}
?>

100000 微秒只是一个可调整的退让起点，不应被写成所有环境都必须相同的固定答案。连接数量、网络环境和 PHP/libcurl 组合不同，应该通过运行指标观察 CPU 占用与请求延迟，再调整这个等待量。

完成请求后读取消息并清理句柄

$stillRunning 变成 0 只说明没有仍在传输的 easy handle；完成请求的 HTTP 状态、错误码和响应内容仍要通过 curl_multi_info_read() 与对应 easy handle 读取。读取完成后移除 easy handle，所有请求处理完再关闭 multi handle。

 $info['result'],
            'content' => curl_multi_getcontent($handle),
        ];

        // 从 multi 集合中移除已完成句柄，再由调用方关闭 easy handle。
        curl_multi_remove_handle($multi, $handle);
        curl_close($handle);
    }

    // multi handle 不再需要时关闭，避免资源生命周期悬挂。
    curl_multi_close($multi);
    return $results;
}
?>

示例中的 $handles 只是“句柄到业务键”的映射，实际项目可以用对象属性或数组结构保存。重要的是不要把完成消息读取、句柄移除和 multi 关闭遗漏在异常路径之外。

PHP 8.4 中还要留意 timeout 参数

官方手册记录，PHP 8.4 起，timeout 小于 0 或大于 PHP_INT_MAX 会抛出 ValueError。因此，修复 -1 空转时不要顺手把 timeout 改成负数来表示“不等待”；应使用非负的有限秒数，并把“没有活动”和“select 失败”交给返回值分支处理。

排查清单：循环仍然占满 CPU 时看什么

• 是否只在 -1 分支退让，而不是把所有返回值都当成错误重试？
• 是否每次退让后都再次调用 curl_multi_exec，并检查返回码？
• 是否在循环中处理了 curl_multi_info_read，避免完成句柄一直留在集合里？
• 是否在异常和正常结束路径都移除 easy handle 并关闭 multi handle？
• 是否记录 PHP、libcurl、操作系统和实际 timeout，便于判断是否属于兼容性边界？

常见问题

curl_multi_select 返回 0 是错误吗？

不是。它表示本次等待到期但没有发现活动，通常继续推进 curl_multi_exec 即可。

返回 -1 后能不能直接 continue？

可以继续循环，但应先短暂等待；否则在没有可监视描述符的环境中可能形成忙等。

为什么还要调用 curl_multi_info_read？

它用于取出已经完成的传输消息。stillRunning 只表示是否仍有活动传输，不替代完成结果读取。