PHP MySQLi：UPDATE操作错误处理与结果集管理

本教程旨在纠正PHP MySQLi中对UPDATE等非SELECT查询误用`mysqli_stmt_get_result`的常见错误。我们将探讨如何通过配置`mysqli_report`实现更健壮的错误报告机制，简化预处理语句的编写，并明确指出UPDATE操作无需获取结果集。同时，强调在重定向后使用`exit`的重要性，以确保代码逻辑的正确执行和安全性。

理解 MySQLi 预处理语句与结果集

在使用 PHP 的 MySQLi 扩展进行数据库操作时，预处理语句（Prepared Statements）是防止 SQL 注入的推荐方式。它将 SQL 查询的结构与数据分离，先准备查询模板，再绑定数据执行。然而，不同类型的 SQL 查询（如 SELECT、INSERT、UPDATE、DELETE）对结果的处理方式是不同的。

核心问题在于，mysqli_stmt_get_result() 函数专用于获取那些会返回结果集（Result Set）的查询，即 SELECT 语句。对于 UPDATE、INSERT 或 DELETE 这类数据操作语言（DML）语句，它们只返回受影响的行数或操作是否成功，并不会产生一个可遍历的结果集。因此，在 UPDATE 查询后尝试调用 mysqli_stmt_get_result() 将是无效的，并且会导致不必要的复杂性或错误。

优化错误报告机制

传统的 MySQLi 错误处理通常涉及在每个函数调用后手动检查返回值，例如 if (!mysqli_stmt_prepare($stmt, $sql))。这种方式不仅冗余，而且容易遗漏。通过配置 mysqli_report，我们可以让 MySQLi 在遇到错误时自动抛出异常，从而简化错误处理逻辑，并提高代码的健壮性。

在数据库连接之前，添加以下代码：

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

这行代码指示 MySQLi 在发生错误时抛出 mysqli_sql_exception 异常，并且以严格模式运行，这意味着所有警告也会被视为错误。启用此设置后，您将不再需要对每个 mysqli_ 函数调用进行手动错误检查，只需在更高级别的 try-catch 块中捕获异常即可。

重构 UPDATE 操作函数

基于上述理解和优化，我们可以对 updateAvatar 函数进行重构。原函数中存在以下问题：

1. 在 UPDATE 查询后尝试使用 mysqli_stmt_get_result()、mysqli_fetch_assoc()。
2. 冗余的错误检查（在启用 mysqli_report 后不再需要）。
3. 在 header("location: ...") 后缺少 exit;。

以下是优化后的 updateAvatar 函数示例：

getMessage());
//     header("location: ../admin/account.php?error=db_error");
//     exit;
// } catch (Exception $e) {
//     // 处理其他异常
//     error_log("Application error: " . $e->getMessage());
//     header("location: ../admin/account.php?error=app_error");
//     exit;
// }

关键注意事项与最佳实践

1. mysqli_stmt_get_result() 的适用性： 明确此函数仅用于 SELECT 查询。对于 UPDATE、INSERT、DELETE 等 DML 操作，您不需要获取结果集。如果您需要验证操作是否成功或获取受影响的行数，可以使用 mysqli_stmt_affected_rows($stmt)。
2. mysqli_report 的重要性： 配置 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); 是现代 PHP MySQLi 开发的推荐做法。它将数据库错误转换为异常，使错误处理更加集中和高效，避免了分散的 if (!...) 检查。
3. header("location: ...") 后跟 exit;： header() 函数仅仅是发送一个 HTTP 头给浏览器，它并不会停止脚本的执行。如果不在其后调用 exit;（或 die;），脚本会继续执行后续代码，这可能导致意外的行为、安全漏洞或双重重定向。
4. 文件上传处理： 将文件上传逻辑与数据库操作逻辑适当分离，提高代码的可读性和可维护性。确保文件上传路径的安全性和权限设置。
5. 类型声明： 在函数签名中使用类型声明（如 mysqli $conn, string $username, string $avatar, : never）可以提高代码的可读性、可维护性，并允许 IDE 进行更好的静态分析。never 返回类型提示表示函数永远不会返回，因为它总是通过 exit 终止脚本。

总结

通过理解 MySQLi 预处理语句的不同行为，并采用现代的错误报告机制，我们可以编写出更简洁、健壮且安全的数据库操作代码。对于 UPDATE、INSERT、DELETE 等非查询操作，避免使用 mysqli_stmt_get_result()，并始终记住在 HTTP 重定向后使用 exit; 来确保脚本的正确终止。