mysqli::get_warnings 与 mysqli::query 一起使用的正确方式

gitbox 2025-06-04

在使用 PHP 的 mysqli 扩展进行数据库操作时，我们通常会关注查询是否成功以及是否抛出了错误，但有一种常被忽略的情况就是：。如果不特别处理这些警告，它们可能隐藏着潜在的问题，比如字段截断、默认值被替代等。本文将分享如何结合使用 mysqli::query() 和 mysqli::get_warnings() 来捕获这些警告，并给出最佳实践。

为什么需要关注 SQL Warnings？

考虑这样一个 SQL：

$sql = "INSERT INTO users (username, email) VALUES ('this_is_a_very_long_username_that_will_be_truncated', '[email protected]')";

假设 username 字段的最大长度是 30 个字符，上面的 SQL 实际执行会被截断，虽然不会抛出错误，但会产生一个 warning。如果我们忽略它，数据就悄悄“被处理”了，而你却毫不知情。

mysqli::get_warnings 是做什么的？

mysqli::get_warnings() 是用来获取上一个操作中的 SQL 警告信息的方法。它会返回一个包含警告级别、代码和消息的对象，可以用来调试或者记录日志。

实际使用示例

我们先看看一个最小示例来理解基本用法：

<?php

$mysqli = new mysqli("localhost", "user", "password", "test");

if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}

$sql = "INSERT INTO demo (name) VALUES ('超长字符串会触发警告超长字符串会触发警告超长字符串会触发警告')";

if ($mysqli->query($sql)) {
    echo "插入成功\n";

    // 检查是否有警告
    $warning = $mysqli->get_warnings();
    while ($warning) {
        echo "警告: [{$warning->errno}] {$warning->message}\n";
        $warning = $warning->next();
    }

} else {
    echo "查询失败: " . $mysqli->error;
}

$mysqli->close();

实战建议：将警告日志化处理

在实际项目中，不建议直接将警告输出给用户，而是推荐将其记录到日志中。例如：

function log_warnings($mysqli) {
    $warning = $mysqli->get_warnings();
    while ($warning) {
        error_log("SQL Warning [{$warning->errno}]: {$warning->message}");
        $warning = $warning->next();
    }
}

$sql = "UPDATE users SET username='过长的名字将被截断' WHERE id=1";

if ($mysqli->query($sql)) {
    log_warnings($mysqli);
} else {
    error_log("SQL Error: " . $mysqli->error);
}

记录到日志中不仅有助于后期排查问题，还可以在测试环境中对 SQL 质量做出反馈。

注意事项

get_warnings() 只适用于最近一次查询；
它返回的是一个类似链表的对象，通过 next() 遍历；
不是所有驱动都完全支持 warnings，使用前需要测试数据库配置；
mysqli_report() 不能替代 get_warnings()，前者更关注错误（errors）；
使用准备语句 (prepare) 和绑定参数时一样可以触发并获取警告。

补充：在生产环境中使用

你可能希望在生产环境中将警告汇总并定期上报，这可以通过封装一个数据库助手类来实现：

class DB {
    protected $mysqli;

    public function __construct() {
        $this->mysqli = new mysqli("localhost", "user", "password", "appdb");
    }

    public function query($sql) {
        $result = $this->mysqli->query($sql);
        if ($result) {
            $this->logWarnings();
        } else {
            error_log("SQL Error: " . $this->mysqli->error);
        }
        return $result;
    }

    protected function logWarnings() {
        $warning = $this->mysqli->get_warnings();
        while ($warning) {
            error_log("[DB警告] {$warning->errno} - {$warning->message}");
            $warning = $warning->next();
        }
    }
}

$db = new DB();
$db->query("UPDATE posts SET title='标题过长会触发警告，注意长度控制' WHERE id=42");

总结

mysqli::query() 是执行 SQL 的利器，而 mysqli::get_warnings() 则是保障数据完整性的重要补充。不要忽略这些警告信息，它们往往藏着你未来的 Bug。养成在开发或测试环境中捕捉并处理 warning 的习惯，将显著提升你项目的健壮性和可维护性。

记住：错误让程序挂掉，警告让你掉坑。