如何使用mysqli::$errno 和mysqli_report() 提高PHP 調試效率，快速定位數據庫連接錯誤？

M66 2025-06-23

在日常的PHP 開發中，數據庫連接錯誤是一個常見但令人頭疼的問題。尤其在使用MySQLi 擴展時，錯誤信息往往模糊不清，不易快速定位問題源頭。為了提升調試效率， mysqli::$errno和mysqli_report()這兩個工具顯得尤為重要。本文將深入介紹它們的作用與使用方法，幫助開發者快速識別並解決數據庫連接錯誤。

一、什麼是mysqli::$errno？

mysqli::$errno是MySQLi 面向對象接口中的一個屬性，用於返回最近一次數據庫操作產生的錯誤代碼。如果沒有錯誤，返回值為0。通過判斷這個錯誤碼，開發者可以更清晰地知道出錯的類型，比如是否是認證失敗、數據庫不存在等。

示例：

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

if ($mysqli->connect_errno) {
    echo "連接失敗，錯誤碼： " . $mysqli->connect_errno . "\n";
    echo "錯誤訊息： " . $mysqli->connect_error . "\n";
    // 可根据錯誤碼做精细化处理
    if ($mysqli->connect_errno === 1045) {
        echo "提示：請檢查數據庫用戶名或密碼是否正確。";
    }
}

在上述示例中，如果密碼錯誤，會返回錯誤碼1045 ，表示認證失敗。通過判斷這個錯誤碼，我們可以定向提示用戶或開發者進行修正。

二、什麼是mysqli_report()？

mysqli_report()是一個配置函數，用於設置MySQLi 擴展的錯誤報告行為。默認情況下，MySQLi 錯誤只返回布爾值或空值，開發者必須手動檢查每一步操作。而開啟錯誤報告之後，MySQLi 會拋出警告或異常，從而簡化調試過程。

常見的報告級別：

MYSQLI_REPORT_OFF ：關閉所有錯誤報告（默認）。
MYSQLI_REPORT_ERROR ：報告錯誤。
MYSQLI_REPORT_STRICT ：以異常形式拋出錯誤（推薦）。
MYSQLI_REPORT_ALL ：報告所有錯誤，包括語法警告等。

示例：

 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

try {
    $mysqli = new mysqli("localhost", "user", "wrong_password", "database");
    // 執行一條錯誤的查詢
    $mysqli->query("SELECT * FROM 不存在的表");
} catch (mysqli_sql_exception $e) {
    echo "發生錯誤： " . $e->getMessage() . "\n";
    echo "錯誤代碼： " . $e->getCode() . "\n";
    // 可以進一步記錄日誌或上報錯誤
    file_put_contents("/var/log/db_errors.log", $e->getMessage(), FILE_APPEND);
}

這種寫法不僅簡化了代碼邏輯，還能快速定位錯誤發生的位置，非常適合開發階段使用。

三、實戰技巧：結合errno 和報告機制快速定位錯誤

在實際項目中，建議你在開發或測試環境中開啟嚴格的錯誤報告機制（使用mysqli_report() ），同時在捕獲異常時結合mysqli::$errno進行更細緻的判斷。

推薦的初始化代碼結構：

 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

try {
    $mysqli = new mysqli("localhost", "user", "password", "database");
    echo "數據庫連接成功";
} catch (mysqli_sql_exception $e) {
    echo "数据库連接失敗，錯誤訊息： " . $e->getMessage();
    
    // 如果需要追踪具体錯誤碼
    if (strpos($e->getMessage(), '1049') !== false) {
        echo "\n提示：數據庫不存在，請檢查數據庫名稱。";
    } elseif (strpos($e->getMessage(), '1045') !== false) {
        echo "\n提示：用戶名或密碼錯誤，請檢查認證信息。";
    }
}

你還可以結合自定義日誌系統，將錯誤信息記錄到本地或遠程日誌服務，比如：

 $logData = date('Y-m-d H:i:s') . " 數據庫錯誤: " . $e->getMessage() . "\n";
file_put_contents("https://m66.net/logs/db_errors.log", $logData, FILE_APPEND);

注意：上面示例中的URL 域名已替換為m66.net ，請根據實際情況處理遠程日誌接收邏輯。

四、總結

通過合理使用mysqli::$errno和mysqli_report() ，可以顯著提升PHP 調試效率，在數據庫連接出現問題時第一時間發現並定位錯誤。推薦在開發環境中始終啟用嚴格模式（ MYSQLI_REPORT_STRICT ），在生產環境中配合異常處理機制進行安全降級或日誌記錄。

調試不是目的，穩定才是目標。用好這兩個小工具，將讓你的PHP 數據庫操作更加可控、可測、可維護。

mysqli::$errno