mysqli_stmt::free_result 報錯“no result set” 的原因與修復

gitbox 2025-06-07

在PHP 中使用MySQLi 擴展進行數據庫操作時，我們常常需要利用mysqli_stmt::free_result()來釋放執行結果集，避免內存洩漏。然而，在實際開發中，可能會遇到mysqli_stmt::free_result報錯“no result set”的問題。本文將詳細分析此問題的常見原因及其解決方法。

什麼是mysqli_stmt::free_result ？

mysqli_stmt::free_result()是MySQLi 擴展中一個用來釋放查詢結果集的方法。通常在執行SELECT 查詢後，如果不再需要結果集，調用該方法可以釋放內存，減少資源消耗。

例如：

 $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);
$stmt->execute();
$stmt->store_result();  // 存儲結果
// 此時可以進行數據處理...
$stmt->free_result();  // 釋放結果集

錯誤描述：“no result set”

報錯“no result set”通常發生在調用free_result()時，程序並沒有執行一個查詢操作，或者查詢並沒有返回結果集。具體來說，這個錯誤的意思是： free_result()方法試圖釋放一個不存在的結果集。

常見原因分析

查詢類型不匹配：
如果執行的是一個非SELECT 類型的查詢（如INSERT、UPDATE、DELETE 等），這些查詢不產生結果集，因此調用free_result()會導致此錯誤。
解決方案：
確保free_result()只在SELECT 查詢之後調用。
```
 $stmt = $mysqli->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->bind_param("ss", $name, $email);
$stmt->execute();
// 不要調用 free_result()，因為沒有結果集
```
未調用store_result()或bind_result() ：
在執行SELECT 查詢後，只有調用了store_result()或bind_result()才會生成結果集。如果在沒有生成結果集的情況下調用free_result() ，就會報錯。
解決方案：
在調用free_result()之前，確保已經調用了store_result()或bind_result() 。
```
 $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);
$stmt->execute();
$stmt->store_result();  // 確保結果集已經存儲
$stmt->free_result();   // 現在可以安全調用
```
查詢未成功執行：
如果SQL 查詢由於某種原因沒有成功執行（如語法錯誤、連接問題等），則沒有結果集返回，調用free_result()時會報錯。
解決方案：
確保SQL 查詢執行成功後再調用free_result() 。可以通過檢查查詢是否成功執行來避免此問題。
```
 $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
if ($stmt === false) {
    die('MySQL prepare failed: ' . $mysqli->error);
}
$stmt->bind_param("i", $userId);
$stmt->execute();
if ($stmt->affected_rows > 0) {
    $stmt->store_result();
    $stmt->free_result();
}
```

提前關閉語句：
如果在執行查詢並存儲結果之前，提前關閉了查詢語句（ $stmt->close() ），則會導致查詢結果無法訪問，調用free_result()時會出現錯誤。

解決方案：
確保在完成查詢處理後，再關閉語句。

 $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);
$stmt->execute();
$stmt->store_result();  // 必须先存儲結果
$stmt->free_result();   // 然後才能釋放結果
$stmt->close();         // 最後關閉語句

查詢返回空結果集：
如果SELECT 查詢沒有返回任何結果（例如查詢條件不匹配），調用free_result()通常不會報錯，但某些配置或環境下可能會出現不一致的行為。雖然這不是報錯的直接原因，但有時候會引發其他意外問題。
解決方案：
在調用free_result()前檢查查詢是否有返回數據。
```
 $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);
$stmt->execute();
$stmt->store_result();

if ($stmt->num_rows > 0) {
    // 有結果
    $stmt->free_result();
} else {
    echo "沒有查詢到結果";
}
```

結論

mysqli_stmt::free_result報錯“no result set”通常是由於查詢沒有返回結果集，或者在沒有正確調用store_result()或bind_result()的情況下調用了free_result() 。為了避免此類錯誤，開發者應當注意以下幾點：

確保free_result()僅在SELECT 查詢之後調用。
在調用free_result()前，務必執行store_result()或bind_result() 。
檢查SQL 查詢是否執行成功。
在關閉語句前完成所有操作。

通過以上的方法和技巧，可以有效避免該錯誤並確保數據庫操作的順利進行。

mysqli_stmt::free_result