PHP中 $stmt->execute() 与 $stmt->affected_rows 的区别详解：执行成功≠数据变更
在使用 PHP 操作 MySQL 的过程中，$stmt->execute() 与 $stmt->affected_rows 是两个常用但容易混淆的属性。许多开发者在处理 UPDATE、DELETE 操作时，常因错误判断导致误报“操作失败”，进而引发逻辑漏洞。
本文将深入剖析二者的区别、使用场景与常见误区，帮助开发者更准确地控制数据更新流程。
一、基础概念
1. $stmt->execute()
表示 SQL 语句是否执行成功。只要语法正确，SQL 成功传递给数据库，且未抛出错误（如字段不存在、语法错误、权限不足等），即视为成功。
✅ 返回
true：语句执行成功（不代表数据真的更新了）❌ 返回
false：语句执行失败，常见原因如 SQL 错误、参数未绑定等
2. $stmt->affected_rows
表示 SQL 语句实际影响的行数，其行为因 SQL 类型而异：
| 操作类型 | 含义 |
|---|---|
INSERT | 成功插入的行数 |
UPDATE | 实际变更的行数（值确实改变才计入） |
DELETE | 实际被删除的行数 |
⚠️ 注意：若执行的
UPDATE语句未引起字段值的变化，即使语句执行成功，affected_rows也会返回0！
二、典型场景举例
示例：更新用户的 token
$stmt = $conn->prepare("UPDATE User SET token = ? WHERE openid = ?");
$stmt->bind_param("ss", $token, $openid);
$stmt->execute();
if ($stmt->affected_rows > 0) {
echo "Token 更新成功";
} else {
echo "Token 更新失败";
}问题出现：
若数据库中原本的 token 就等于 $token，UPDATE 虽然执行成功，但 affected_rows 为 0，会错误提示“更新失败”。
三、推荐判断方式
✅ 推荐方案一：只看执行是否成功
if ($stmt->execute()) {
echo "SQL执行成功";
} else {
echo "SQL执行失败：" . $stmt->error;
}适用于：
不强依赖“是否变更了行”的判断
允许“值相同不更新”的语义场景（如重复设置 token）
✅ 推荐方案二：同时判断值是否真的改变（更严谨）
$updated = false;
if ($stmt->execute()) {
if ($stmt->affected_rows > 0) {
$updated = true;
} else {
// 检查原值是否与目标值一致
$checkStmt = $conn->prepare("SELECT token FROM User WHERE openid = ?");
$checkStmt->bind_param("s", $openid);
$checkStmt->execute();
$result = $checkStmt->get_result();
if ($row = $result->fetch_assoc()) {
$updated = ($row['token'] === $token);
}
}
}
if ($updated) {
echo "Token 保存成功";
} else {
echo "Token 更新失败或未修改";
}适用于：
需明确判断是否已成功设定目标值
场景要求必须有结果确认的业务逻辑（如登录状态刷新、设置唯一标识）
四、常见误区
| 误区 | 正确认知 |
|---|---|
execute() 返回 true 说明数据库改了 | ❌ 不一定，值可能没变 |
affected_rows == 0 就是失败 | ❌ 可能是值本来就一致 |
UPDATE 一定会更新行 | ❌ 前提是值有实际变化 |
只有 affected_rows > 0 才要执行后续逻辑 | ❌ 有时 0 也表示“无需修改但逻辑成功” |
五、最佳实践建议
仅验证 SQL 成功时：使用
execute()即可。必须确认字段已变更时：配合使用
affected_rows或主动读取旧值比对。写入幂等操作（如设置 token、配置项）：不要强依赖
affected_rows > 0。写接口返回状态时：明确区分“操作失败”与“无必要变更”。
六、总结对比表
| 属性 | 用途 | 是否表示值已变更 | 是否表示 SQL 成功 |
|---|---|---|---|
$stmt->execute() | 判断语句是否成功执行 | ❌ | ✅ |
$stmt->affected_rows | 判断是否实际影响数据库数据 | ✅ | ❌（不表示执行成功） |
✅ 一句话总结：
execute()判断执行是否成功，affected_rows判断数据是否改变，两者缺一不可，视业务而定。
如需进一步保障逻辑严密性，建议封装一套统一的数据库操作逻辑方法，对 UPDATE 等操作做兼容性判断，提高系统的健壮性。
