用 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