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