PHP API实现数据库行存在则更新数量、不存在则插入的高效方案问询

必须给你推荐这个方案！你现在的两次查询不仅多了一次数据库交互，还在高并发场景下可能出现竞态问题（比如第一次查询发现不存在，但插入前有其他进程先插入了相同的行）。而INSERT ... ON DUPLICATE KEY UPDATE可以把这两步合并成一个原子操作，效率更高还更安全。

第一步：创建唯一联合索引 #

这个语法的核心是依赖「唯一键冲突」来触发更新逻辑，所以你需要先给inventory表的user、location、item、weight、comment字段创建唯一联合索引：

ALTER TABLE `inventory` ADD UNIQUE INDEX `idx_unique_inventory` (`user`, `location`, `item`, `weight`, `comment`);

确保这几个字段的组合确实是业务上的唯一标识——只有当这五个字段完全匹配时，才会触发更新而不是插入。

第二步：修改PHP代码为单条操作 #

把你原来的两次查询逻辑替换成下面的代码，只需要一次prepare和execute：

// 准备INSERT ... ON DUPLICATE KEY UPDATE语句
$stmt = $i_conn->prepare("
    INSERT INTO `inventory`(`user`, `location`, `item`, `quantity`, `weight`, `comment`)
    VALUES (?, ?, ?, ?, ?, ?)
    ON DUPLICATE KEY UPDATE `quantity` = `quantity` + ?
");

// 绑定参数：注意最后多了一个$itemQuantity，对应UPDATE部分的增量
$stmt->bind_param("iiiiiii", $userId, $locationId, $itemId, $itemQuantity, $itemWeight, $commentId, $itemQuantity);

// 执行语句
$stmt->execute();

// 可以获取受影响的行数，判断是插入还是更新
$affectedRows = $stmt->affected_rows;
if ($affectedRows === 1) {
    echo "新行已插入";
} elseif ($affectedRows === 2) {
    echo "已有行已更新";
}

为什么这比原来的方案更好？ #

• 更少的数据库交互：从两次查询+一次写入变成一次写入操作，减少了网络往返开销，提升性能。
• 原子性：整个操作是数据库层面的原子操作，不会出现中间状态，彻底避免并发场景下的竞态问题。
• 代码更简洁：省去了判断查询结果的逻辑，代码可读性更高。

注意事项 #

• 确认唯一索引的字段组合完全符合你的业务需求，不能漏字段也不能多字段，否则会导致逻辑错误。
• 如果你的表中已经有其他唯一键，要确保不会和这个联合索引产生冲突。
• affected_rows返回1表示插入了新行，返回2表示更新了已有行（因为MySQL会先尝试插入，失败后执行更新，所以计数是2）。

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