sql 查询执行成功与否，取决于是否发生语法错误、连接中断、权限不足等运行时异常；即使影响行为为零（如 update 未匹配到任何行），只要语句被数据库正常接收并执行完毕，即视为成功。
sql 查询执行成功与否，取决于是否发生语法错误、连接中断、权限不足等运行时异常；即使影响行为为零（如 update 未匹配到任何行），只要语句被数据库正常接收并执行完毕，即视为成功。
在使用 PHP 的 MySQLi 预处理语句（如 mysqli_stmt::execute()）时，返回值 true（或整数 1）仅表示语句已成功提交至数据库并完成执行，不表示“有数据被修改”。同理，返回 false（或 0）仅表示执行阶段发生了可捕获的错误，例如：
- SQL 语法错误（如拼写错误、缺少括号）
- 数据库连接意外断开
- 参数类型不匹配（如用字符串绑定整型占位符且严格模式开启）
- 权限不足（如无 UPDATE 权限）
- 唯一约束冲突（INSERT/UPDATE 违反 UNIQUE 或 PRIMARY KEY）
⚠️ 关键误区澄清：
✅ UPDATE ... WHERE id = 5 匹配 0 行 → 执行成功（$result === true），$stmt->affected_rows === 0
✅ UPDATE ... WHERE id = 5 匹配 3 行 → 执行成功（$result === true），$stmt->affected_rows === 3
❌ UPDATE ... SET col = ? WHERE id = ? 但 bind_param("i", $str) 传入非整型 → 执行失败（$result === false），触发警告或异常（取决于错误报告设置）
因此，正确判断逻辑应分层处理：
$test_id = 5;
$stmt = $this->conn->prepare("UPDATE test_db SET request_time = NOW() WHERE id = ?");
$stmt->bind_param("i", $test_id);
if (!$stmt->execute()) {
// 仅在此处处理真正意义上的“执行失败”
throw new RuntimeException("SQL execution failed: " . $stmt->error);
}
// 执行成功后，按需检查影响行数
if ($stmt->affected_rows === 0) {
error_log("Warning: No row was updated for ID {$test_id}");
// 可选：抛出业务逻辑异常，或返回 null / false 等语义化结果
}? 最佳实践建议：
-
不要依赖
execute()返回值判断业务逻辑是否“生效”，而应结合affected_rows（DML）或num_rows（SELECT）进一步验证； -
启用异常模式（推荐）：通过
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);和mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);让错误自动抛出mysqli_sql_exception，避免手动检查每个execute()； -
始终记录或监控
affected_rows—— 它才是反映 DML 实际效果的核心指标，而非执行函数的布尔返回值。
简言之：成功 = 无异常；效果 = 看 affected_rows。
