類型錯誤：嘗試在非mysqli_result 對像上調用方法

M66 2025-05-28

在使用PHP 進行數據庫操作時，遇到錯誤是常見的現象之一。其中，“在不是mysqli_result 的對像上調用方法”這個錯誤通常與數據庫查詢結果處理相關。我們來分析一下這個錯誤的原因，並且提供如何解決它的思路。

1. 錯誤的背景

在PHP 中，使用mysqli擴展進行數據庫操作時，我們通常會執行查詢並期望從數據庫中獲取一個結果集，這個結果集是一個mysqli_result對象。這個對象可以使用一系列方法來訪問查詢的結果。

例如，執行如下SQL 查詢：

 $sql = "SELECT * FROM users WHERE id = 1";
$result = $mysqli->query($sql);

$result變量本應該是一個mysqli_result對象，如果查詢成功，可以繼續用它來獲取查詢數據：

 $row = $result->fetch_assoc();  // 獲取一行數據

然而，在某些情況下， $result可能並不是mysqli_result類型，而是一個其他的對像或變量。這時，就會報出類似“在不是mysqli_result 的對像上調用方法”的錯誤。

2. 錯誤原因

這種錯誤的原因通常是以下幾種：

查詢失敗：如果query()方法執行失敗，它會返回false而不是mysqli_result對象。這時，如果繼續對$result調用fetch_assoc()或其他方法，就會出現類型錯誤。
例如：
```
 $result = $mysqli->query($sql);
if ($result === false) {
    die("查詢失敗: " . $mysqli->error);
}
```
這段代碼確保了在查詢失敗時不會繼續調用mysqli_result的方法，從而避免類型錯誤。
連接錯誤：如果數據庫連接失敗， $mysqli對象本身就不可以正常工作。確保數據庫連接成功：
```
 $mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}
```
如果數據庫連接沒有成功，後續的查詢將無法執行，因此$result也不會是mysqli_result類型。
調用錯誤：有時由於邏輯問題，程序可能在不正確的地方調用了fetch_assoc()等方法，導致$result並不是查詢結果對象。
解決此問題時，可以添加調試代碼來檢查$result的類型，確認它是mysqli_result對象：
```
 var_dump($result);
```

3. 解決方法

為了避免這種類型錯誤，確保在查詢操作後檢查$result是否為有效的mysqli_result對象。以下是一個改進的代碼示例：

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

// 檢查連接是否成功
if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

$sql = "SELECT * FROM users WHERE id = 1";
$result = $mysqli->query($sql);

// 檢查查詢是否成功
if ($result === false) {
    die("查詢失敗: " . $mysqli->error);
}

// 處理查詢結果
while ($row = $result->fetch_assoc()) {
    echo "用戶ID: " . $row['id'] . " 用戶名: " . $row['name'] . "<br>";
}
?>

通過檢查query()方法的返回值，確保其返回的是有效的mysqli_result對象，這樣就能避免類型錯誤。

4. 總結

當在PHP 中使用mysqli擴展時，錯誤的發生往往與查詢失敗或不正確的對像類型調用有關。確保在每次查詢後驗證結果集是否有效，避免在錯誤對像上調用方法，是解決這種類型錯誤的關鍵。