next_result() 在循环中使用时造成死循环的原因分析

gitbox 2025-04-29

在使用 PHP 进行数据库操作，尤其是在使用 MySQLi 的多结果集（multi_query）功能时，开发者经常会用到 next_result() 函数。然而，若在循环中使用不当，就有可能触发，导致脚本无法正常结束。本文将详细分析其发生的原因，并提供可靠的解决方案。

一、问题重现

假设我们有一段使用 multi_query 执行多个 SQL 语句的代码：

$mysqli = new mysqli("localhost", "user", "password", "database");

$sql = "
    SELECT * FROM users;
    SELECT * FROM orders;
    SELECT * FROM products;
";

if ($mysqli->multi_query($sql)) {
    do {
        if ($result = $mysqli->store_result()) {
            while ($row = $result->fetch_assoc()) {
                print_r($row);
            }
            $result->free();
        }
        // 此处是关键
    } while ($mysqli->next_result());
}

在这段代码中，我们希望顺序执行三条 SELECT 语句，并处理它们各自的结果集。next_result() 的作用是准备下一个结果集。

问题来了： 若最后一次调用 next_result() 时返回的是 true，但 store_result() 却返回了 false（因为没有更多的结果集），就会进入死循环。

二、为什么会死循环？

next_result() 的作用是让 mysqli 移动到下一个结果集，并返回布尔值：

返回 true 表示还有更多结果集，或者说成功切换；
返回 false 表示没有更多结果集或出现错误。

然而，当最后一个结果集是空的结果集（如最后一条语句是 SELECT 但没有结果，或者是非查询语句如 UPDATE），此时 store_result() 返回 false，但 next_result() 依然可能返回 true，导致 do...while 继续执行——没有退出条件，死循环发生！

三、解决方法

? 方法一：检查是否还有更多结果集

可以结合 more_results() 方法判断是否还有结果集可以处理：

$mysqli = new mysqli("localhost", "user", "password", "database");

$sql = "
    SELECT * FROM users;
    SELECT * FROM orders;
    UPDATE users SET status = 'active' WHERE id = 1;
";

if ($mysqli->multi_query($sql)) {
    do {
        if ($result = $mysqli->store_result()) {
            while ($row = $result->fetch_assoc()) {
                print_r($row);
            }
            $result->free();
        } else {
            // 不是结果集，可能是 UPDATE、INSERT 等
            if ($mysqli->errno) {
                echo "MySQL 错误：" . $mysqli->error;
            }
        }

    } while ($mysqli->more_results() && $mysqli->next_result());
}

? 方法二：设置最大循环次数（防御性）

如果你无法完全判断结果集数量，可以设置一个最大循环次数防止死循环：

$maxLoops = 10;
$loopCounter = 0;

if ($mysqli->multi_query($sql)) {
    do {
        if (++$loopCounter > $maxLoops) {
            echo "检测到可能的死循环，中止操作";
            break;
        }

        if ($result = $mysqli->store_result()) {
            while ($row = $result->fetch_assoc()) {
                print_r($row);
            }
            $result->free();
        }

    } while ($mysqli->next_result());
}

四、总结

在使用 next_result() 时，必须格外注意其返回值不能完全信任。要配合 more_results() 使用，确保只有在确实有下一个结果集时才继续。否则，在某些 SQL 执行路径下容易导致死循环，尤其是当存在空结果集或非查询语句混合执行时。

如需查看更多关于 PHP 和数据库操作的最佳实践，可以访问：

https://gitbox.net/php-mysql-best-practices

next_result