更新原取值为NULL的列时affected_rows返回0是什么原因？

核心原因1：MySQL affected_rows 默认返回实际变更的行数，而非匹配行数 #

MySQL默认配置下，UPDATE操作的受影响行数统计规则是只有行内数据真的发生了变化才会计数，如果满足WHERE条件的行，要更新的column1的值和当前已存储的值完全一致，就算匹配到了行也会返回0：

• 如果你已经执行过一次该UPDATE脚本，column1已经被写入了$value1，后续再执行时就算column3 IS NULL条件仍然满足，也不会触发数据变更，返回0
• 如果你绑定的$value1本身就是NULL，和column1原来的NULL值相等，也不会被判定为数据变更

核心原因2：WHERE条件实际未匹配到任何行 #

你确认数据已经写入可能是误判，以下情况都会导致WHERE条件匹配不到行：

• LIKE运算未加通配符：如果$value2没有用%/_包裹，LIKE等价于精确匹配=，只要column2的值和$value2不完全一致就匹配不到
• column3实际不是NULL：很多人会混淆空字符串''和NULL的区别，空字符串属于合法非空值，IS NULL条件无法匹配到这类行

核心原因3：代码未做错误校验，执行实际失败 #

你当前的代码没有判断execute的执行结果，如果UPDATE执行出错，affected_rows也会返回0，常见错误包括SQL语法问题、表/列名拼写错误、数据库账号没有修改权限等。 #

调试与修复方案 #

1. 先添加执行错误校验，排除执行失败问题：

$query->bind_param('ss', $value1, $value2);
$execResult = $query->execute();
if (!$execResult) {
    echo "UPDATE执行错误：" . $query->error;
}

2. 验证WHERE条件的匹配数量：将UPDATE语句替换为同条件的SELECT语句，确认实际匹配行数：

$checkQuery = $conn->prepare("SELECT COUNT(*) as match_count FROM table WHERE column2 LIKE ? AND column3 IS NULL");
$checkQuery->bind_param('s', $value2);
$checkQuery->execute();
$result = $checkQuery->get_result();
$row = $result->fetch_assoc();
echo "匹配到的行数：" . $row['match_count'];

3. 如果需要返回匹配到的行数而非实际变更行数，可以在创建数据库连接时传入MYSQLI_CLIENT_FOUND_ROWS参数：

$conn = mysqli_init();
// 最后一个参数指定返回匹配行数，而非实际变更行数
$conn->real_connect('数据库主机地址', '账号', '密码', '库名', 3306, null, MYSQLI_CLIENT_FOUND_ROWS);

内容的提问来源于stack exchange，提问作者Cranberry