MySQL ON DUPLICATE KEY UPDATE 语法用于处理 Upsert 场景，即数据存在则更新、不存在则插入。当插入操作违反主键或唯一索引约束时触发更新逻辑。常见应用包括计数器累加、配置项维护及购物车数量调整。高级用法支持条件判断更新和批量操作优化。相比 REPLACE INTO 先删后插，该方式性能更优且保留主键；相比 INSERT IGNORE 冲突忽略，它能主动更新数据。使用时需确保表结构包含主键或唯一索引以触发机制。
在日常的数据库操作中，我们经常会遇到这样的场景：如果数据存在，就更新它；如果不存在，就插入一条新的。这种模式通常被称为 Upsert（Update + Insert）。在 MySQL 中，实现 Upsert 最优雅、最高效的方式之一就是使用 ON DUPLICATE KEY UPDATE 语法。
ON DUPLICATE KEY UPDATE 是 MySQL 特有的一种 INSERT 语句扩展，当执行 INSERT 操作时，如果插入的数据与表中已有数据的主键 (PRIMARY KEY) 或唯一索引 (UNIQUE INDEX) 发生冲突（即要插入的值与已有记录的主键或唯一索引值相同），则不执行插入操作，而是转而执行 UPDATE 操作，更新已存在的记录。
ON DUPLICATE KEY UPDATE 子句更新已存在的记录基本语法格式如下：
INSERT INTO table_name (column1, column2, ..., columnN)
VALUES(value1, value2, ..., valueN)
ON DUPLICATE KEY UPDATE column1 = value1, column2 = value2, ...;
更常用的写法是使用 VALUES() 函数来引用原本打算插入的值：
INSERT INTO table_name (column1, column2, ..., columnN)
VALUES(value1, value2, ..., valueN)
ON DUPLICATE KEY UPDATE column1 = VALUES(column1), column2 = VALUES(column2), ...;
⚠️ 触发条件：只有当插入操作违反了 主键（PRIMARY KEY） 或 唯一索引（UNIQUE INDEX） 约束时，UPDATE 部分才会被执行
最常见的应用场景是实现计数器功能，如文章浏览量、点赞数等
INSERT INTO article_views (article_id, view_count)
VALUES(123, 1)
ON DUPLICATE KEY UPDATE view_count = view_count + 1;
当需要更新或插入配置项时
INSERT INTO system_config (config_key, config_value, last_updated)
VALUES('site_title', 'My Website', NOW())
ON DUPLICATE KEY UPDATE config_value = VALUES(config_value), last_updated = NOW();
添加商品到购物车，已存在则更新数量
INSERT INTO shopping_cart (user_id, product_id, quantity)
VALUES(123, 456, 2)
ON DUPLICATE KEY UPDATE quantity = quantity + VALUES(quantity), added_at = CURRENT_TIMESTAMP;
⚠️ 注意：必须添加主键或唯一索引，否则
ON DUPLICATE KEY UPDATE将不会触发，语句会正常执行插入操作（如果无其他错误）
在 ON DUPLICATE KEY UPDATE 子句中使用条件表达式
-- 这个例子只在新的价格更低时才更新价格
INSERT INTO products (product_id, price, last_updated)
VALUES(101, 99.99, NOW())
ON DUPLICATE KEY UPDATE price = IF(VALUES(price) < price, VALUES(price), price), last_updated = NOW();
虽然不能直接在 ON DUPLICATE KEY UPDATE 中使用多表，但可以结合子查询
INSERT INTO user_stats (user_id, login_count)
SELECT 123, 1 FROM dual WHERE NOT EXISTS(SELECT 1 FROM users WHERE id = 123)
ON DUPLICATE KEY UPDATE login_count = login_count + 1;
对于大量数据的批量插入/更新，考虑以下优化
INSERT INTO log_entries (user_id, action, timestamp)
VALUES(1, 'login', NOW()), (2, 'view', NOW()), (3, 'purchase', NOW())
ON DUPLICATE KEY UPDATE action = VALUES(action), timestamp = VALUES(timestamp);
⚠️ 注意：当表有多个唯一约束时，任何唯一键冲突都会触发 UPDATE
实际上是先 DELETE 再 INSERT，主键会有变化
REPLACE INTO users (email, name, login_count)
VALUES('[email protected]', 'Test User', 1);
冲突时直接忽略，不更新
INSERT IGNORE INTO users (email, name)
VALUES('[email protected]', 'Test User');
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
在线格式化和美化您的 SQL 查询（它支持各种 SQL 方言）。 在线工具，SQL 美化和格式化在线工具，online
解析 INSERT 等受限 SQL，导出为 CSV、JSON、XML、YAML、HTML 表格（见页内语法说明）。 在线工具，SQL转CSV/JSON/XML在线工具，online
CSV 与 JSON/XML/HTML/TSV/SQL 等互转，单页多 Tab。 在线工具，CSV 工具包在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online