調用next_result() 前忘記清空前一個結果集會發生什麼？

在使用PHP 的MySQLi 擴展進行數據庫多查詢（multi-query）操作時， next_result()是一個至關重要的函數。它用於處理存儲過程或一次性發送多條SQL 語句後的多個結果集。但很多開發者在使用next_result()時，會忽略一個細節：在調用next_result()之前，如果沒有清空上一個結果集，可能會導致嚴重的問題。

多查詢操作的基本流程

使用mysqli::multi_query()執行多條SQL 語句時，每一條語句都可能返回一個結果集。你需要用store_result()或use_result()來處理當前的結果集，然後再用next_result()移動到下一個結果集。

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

$sql = "SELECT * FROM users; 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());
}

如果忘記清空當前結果集，會發生什麼？

1. 阻塞後續結果集處理

mysqli::next_result()的工作前提是當前結果集已被清空或釋放。如果你跳過了store_result()或free()步驟， next_result()可能無法正確移動到下一個結果集，導致後續查詢結果永遠不會被處理。

2. 導致"Commands out of sync" 錯誤

這是最常見的錯誤信息：

 Commands out of sync; you can't run this command now

這個錯誤意味著你對MySQL 的操作順序不對，比如在處理完當前結果集前，就嘗試執行新查詢或訪問下一結果集。

3. 潛在內存洩漏

雖然PHP 的垃圾回收機制通常能自動處理資源，但在大數據量或長連接場景下，如果不手動free()當前結果集，有可能造成內存緩慢增長，最終影響應用性能。

如何避免這些問題？

• 始終調用store_result()並及時free()當前結果集。

• 使用清晰的循環結構來確保每一個結果集都被處理乾淨。

• 為每個步驟添加錯誤檢查，避免邏輯漏網之魚。

 if ($mysqli->multi_query($sql)) {
    do {
        if ($result = $mysqli->store_result()) {
            // 處理結果
            $result->free();
        } else {
            if ($mysqli->errno) {
                echo "查詢失敗: " . $mysqli->error . "<br>";
            }
        }
    } while ($mysqli->more_results() && $mysqli->next_result());
}

結語

在使用multi_query()和next_result()時，務必牢記：處理完一個結果集再去請求下一個，是你與數據庫良好互動的基本禮儀。不然，你可能很快會在gitbox.net的bug 提交系統裡，看到很多莫名其妙的“Commands out of sync” 報錯。