本文介绍如何使用 PHP PDO 实现“存在则更新 quantity 字段（累加），不存在则插入新记录”的原子化操作，涵盖手动判断逻辑与更优的 INSERT ... ON DUPLICATE KEY UPDATE 方案。
本文介绍如何使用 php pdo 实现“存在则更新 quantity 字段（累加），不存在则插入新记录”的原子化操作，涵盖手动判断逻辑与更优的 `insert ... on duplicate key update` 方案。
在电商库存、购物车计数或用户行为统计等场景中，常需对某条记录的 quantity 字段执行“若 ID 已存在则累加，否则新建”的操作。虽然可通过先查后判再插/更的方式实现（如问题中提供的 PDO 示例），但该方式存在竞态条件（race condition）风险：在 SELECT 与后续 INSERT/UPDATE 之间，另一并发请求可能已修改数据，导致逻辑错误或重复插入。
推荐方案：使用 INSERT ... ON DUPLICATE KEY UPDATE（MySQL 原生语法）
该语句具备原子性，无需事务包裹即可安全执行。前提是表中 id 字段必须具有唯一约束（如 PRIMARY KEY 或 UNIQUE INDEX）：
INSERT INTO products (id, quantity) VALUES (?, ?) ON DUPLICATE KEY UPDATE quantity = quantity + VALUES(quantity);
对应 PDO 实现如下：
try {
$stmt = $pdo->prepare(
"INSERT INTO products (id, quantity) VALUES (?, ?)
ON DUPLICATE KEY UPDATE quantity = quantity + VALUES(quantity)"
);
$stmt->execute([$id, $quantity]);
echo "操作成功：ID {$id} 的 quantity 已更新或插入。";
} catch (PDOException $e) {
error_log("SQL 错误: " . $e->getMessage());
throw new Exception("库存更新失败，请重试。");
}✅ 优势说明：
- 原子执行，彻底规避并发冲突；
- 仅一次数据库往返，性能优于“查–判–插/更”三步流程；
- 代码简洁，逻辑清晰，易于维护。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 确保 id 列已设置 PRIMARY KEY 或 UNIQUE 约束，否则 ON DUPLICATE KEY UPDATE 不生效；
- 若需获取影响行数（如判断是插入还是更新），可调用 $stmt->rowCount()：返回 1 表示插入，2 表示更新（MySQL 特性）；
- 避免在未开启异常模式（PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION）时忽略错误，务必启用异常捕获以保障健壮性。
补充：兼容性提示
该语法为 MySQL 特有。若使用 PostgreSQL，应改用 INSERT ... ON CONFLICT DO UPDATE；SQLite 则使用 INSERT OR REPLACE（注意其会全量覆盖，非增量更新）。因此，在跨数据库项目中，建议将此逻辑封装为适配器方法。
综上，优先采用 INSERT ... ON DUPLICATE KEY UPDATE 是高效、安全、符合最佳实践的解决方案。
