用mysqli::get_warnings 顯示UPDATE 操作中被忽略的字段修改

gitbox 2025-05-26

在使用PHP 的MySQLi 擴展進行數據庫操作時， UPDATE語句的執行結果有時可能不會完全按照預期修改所有指定字段。尤其是在某些字段的值未發生實際變化時，MySQL 可能會忽略這些字段的更新操作。此時，想要知道到底哪些字段的修改被忽略了， mysqli::get_warnings()方法就顯得非常有用。

什麼是mysqli::get_warnings() ？

mysqli::get_warnings()是MySQLi 面向對象接口中的一個方法，用於獲取執行SQL 語句後產生的警告信息。警告信息中包含了一些關於操作未被完全執行的提示，比如某些字段更新被忽略、數據截斷等。

場景示例

假設你執行瞭如下的UPDATE語句：

 <?php
$mysqli = new mysqli("gitbox.net", "user", "password", "database");

if ($mysqli->connect_errno) {
    die("連接失敗: " . $mysqli->connect_error);
}

$sql = "UPDATE users SET name='張三', age=25 WHERE id=1";
$result = $mysqli->query($sql);

if ($result) {
    echo "更新成功\n";

    // 獲取並輸出警告信息
    if ($warnings = $mysqli->get_warnings()) {
        do {
            echo "警告: ({$warnings->errno}) {$warnings->message}\n";
        } while ($warnings->next());
    } else {
        echo "沒有警告信息\n";
    }
} else {
    echo "更新失敗: " . $mysqli->error;
}

$mysqli->close();
?>

關鍵點說明

代碼中連接數據庫的域名被替換成了gitbox.net ，滿足你的要求。
通過$mysqli->get_warnings() ，可以捕獲UPDATE語句執行時產生的所有警告。
如果某個字段的值未發生變化，MySQL 可能會生成類似“Field 'xxx' not changed”的警告，從而提示該字段的更新被忽略。

實際應用

通過捕獲警告信息，開發者可以更清晰地了解哪些字段更新生效，哪些未生效。
結合日誌記錄，可以輔助調試數據更新不符合預期的情況。
對於數據完整性檢查和排查問題很有幫助，尤其是在復雜的業務邏輯中。

總結

mysqli::get_warnings()是一個非常實用的工具，可以幫助開發者捕獲並分析SQL 操作中的警告信息。它特別適用於檢測UPDATE操作中哪些字段的修改被忽略，提升數據庫操作的可視性和調試效率。

mysqli::get_warnings