MySQL原生驱动异步查询中mysqli_poll函数PHP警告原因

我之前在做PHP异步MySQL查询时也踩过类似的坑——特定环境下mysqli_poll疯狂打Apache错误日志，大概率是连接数组里混了无效/异常连接。咱们一步步拆解排查：

1. 先给连接数组做「体检」，过滤无效连接 #

在调用mysqli_poll之前，一定要逐个校验连接的有效性，把死连接、未初始化的连接统统踢出去：

function filterValidMysqlConnections(array $connections): array {
    $validConns = [];
    foreach ($connections as $conn) {
        // 先判断是不是合法的mysqli连接，再检查是否存活
        if ($conn instanceof mysqli && $conn->connect_errno === 0 && !$conn->closed) {
            // 用ping()确认连接还活著，避免服务器主动断开的「僵尸连接」
            if ($conn->ping()) {
                $validConns[] = $conn;
            } else {
                error_log("废弃无效MySQL连接: " . $conn->connect_error);
                $conn->close();
            }
        } else {
            error_log("发现非mysqli连接或已关闭的连接");
        }
    }
    return $validConns;
}

然后在你的并行查询函数里，先过一遍这个过滤函数再传进mysqli_poll：

$cleanConns = filterValidMysqlConnections($yourRawConnArray);
if (!empty($cleanConns)) {
    // 只给mysqli_poll传干净的连接数组
    $ready = mysqli_poll($cleanConns, $errors, $reject, 5000);
}

2. 检查mysqli_poll的参数使用是否规范 #

很多警告都是参数格式不对导致的，别踩这些细节坑：

• 第一个参数必须是引用传递的mysqli数组（PHP里要确保数组是可修改的，别传常量数组）
• $errors和$reject必须是初始化好的空数组，不能传null或者未定义的变量
• 超时时间（最后一个参数）要合理设置（单位是毫秒），别设成0导致无限等待

正确的调用姿势应该是这样：

$read = $cleanConns;
$errors = [];
$reject = [];
$timeout = 3000; // 3秒超时，根据业务调整

$readyCount = mysqli_poll($read, $errors, $reject, $timeout);

3. 处理mysqli_poll返回后的异常连接 #

就算调用前校验过，poll过程中也可能出现连接断开的情况，及时清理避免后续警告：

if ($readyCount > 0) {
    foreach ($read as $conn) {
        if ($result = $conn->reap_async_query()) {
            // 处理你的查询结果
            // ...
            mysqli_free_result($result);
        } else {
            error_log("异步查询失败: " . $conn->error);
            $conn->close();
        }
    }
}

// 批量处理错误和被拒绝的连接
foreach ($errors as $conn) {
    error_log("poll过程中连接出错: " . $conn->error);
    $conn->close();
}

foreach ($reject as $conn) {
    error_log("连接被MySQL服务器拒绝");
    $conn->close();
}

4. 环境层面的排查（如果以上都没用） #

要是代码层面没问题，就得看服务器配置了：

• 检查PHP的mysqli.allow_persistent参数，避免持久连接泄漏
• 确认MySQL的wait_timeout和interactive_timeout，别让服务器主动断开长连接
• 查看服务器的文件描述符限制，异步查询会占用更多FD，超过限制也会触发异常

最后建议把PHP错误日志开全（error_reporting = E_ALL），能看到警告的具体内容——比如是「无效参数」还是「连接已关闭」，精准定位问题更快。

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