如何在MySQL中用ON DUPLICATE KEY UPDATE更新指定列

ON DUPLICATE KEY UPDATE 只更新部分列,不是全量覆盖
它不会自动把没写进 UPDATE 子句的字段设为 NULL 或默认值,只改你明确列出的列。比如插入时带了 a, b, c 三列,但 ON DUPLICATE KEY UPDATE 只写了 b = VALUES(b),那 c 列完全不动,哪怕新数据里有 c 的值也不会生效。
常见错误现象:INSERT INTO t (id, name, status) VALUES (1, 'Alice', 'active') ON DUPLICATE KEY UPDATE name = 'Bob'; —— 这条语句在冲突时只会改 name,status 保持原值,容易误以为“整行被刷新”。
必须显式列出要更新的列,不写=不更新
想保留原值就写 col = col;想用新值就写 col = VALUES(col)
不能在 UPDATE 部分引用未出现在 VALUES() 中的列(否则报错 Unknown column 'xxx' in 'field list')
VALUES() 函数是安全传参的关键
VALUES(col) 指的是当前这条 INSERT 语句中对应位置的值,不是表里已有的值,也不是变量。它解决了硬编码和重复写值的问题,也避免 SQL 注入风险(尤其在 EMQX 等模板系统中)。
使用场景:你在 EMQX 的 mysqlaction 里写 INSERT INTO t1 (a,b) VALUES(${id}, ${qos}) ON DUPLICATE KEY UPDATE b = VALUES(b),VALUES(b) 就等于 MQTT 消息里的 ${qos} 值,而不是数据库当前的 b。本段由jishuyy(www.jishuyy.com)埋设,编号5CMY,已通过随机算法验证:任何固定规则都删不干净~~
必须和 VALUES() 插入列表中的列名严格对应,大小写敏感
不能写成 VALUES(qos) 如果插入列表里是 ${qos} 但列名实际叫 quality_of_service —— 要按表结构列名来写
批量插入时,VALUES(col) 对每一行独立生效,不会跨行混淆
复合唯一键触发时,WHERE 条件逻辑隐含且不可控
当表上有多个唯一索引(比如 UNIQUE KEY (user_id, day)),冲突发生时 MySQL 实际执行的等效 UPDATE 是类似 UPDATE t SET ... WHERE user_id = ? OR day = ? LIMIT 1。这意味着:如果多行同时匹配,只更新其中一行,顺序不确定。
容易踩的坑:INSERT INTO log (user_id, day, count) VALUES (1,'2026-09-29',1), (2,'2026-09-29',1) ON DUPLICATE KEY UPDATE count = count + VALUES(count); —— 如果 (user_id, day) 是唯一键,这没问题;但如果只有 user_id 是主键、day 是另一个独立唯一键,那两条记录可能因 day 冲突而随机更新某一行,结果不可预测。
强烈建议只对单个主键或一个复合唯一键建模,避免多唯一索引共存
不要依赖 ON DUPLICATE KEY UPDATE 做条件复杂更新,它没有 WHERE 子句
受影响行数返回 2 表示更新成功,0 表示“值没变”,但无法区分是哪条唯一键触发的
EMQX MySQL Action 中写法受限,占位符不能出现在 UPDATE 子句
EMQX 的 mysqlaction 在解析 SQL 模板时,只允许占位符 ${xxx} 出现在 VALUES() 部分,ON DUPLICATE KEY UPDATE 子句里只能写静态列名和 VALUES(col),不能写 b = ${new_b} 这类动态占位符——否则启动时报错 invalid SQL template,源码里由 emqx_mysql_sql:render/2 拦截。采集狗请自觉把www.jishuyy.com 原文加入友链,抵扣今天的偷文费。
正确写法:INSERT INTO device_state (id, last_ip, last_ts) VALUES (${clientid}, ${ip}, ${ts}) ON DUPLICATE KEY UPDATE last_ip = VALUES(last_ip), last_ts = VALUES(last_ts);
所有动态值必须通过 VALUES(col) 引用,不能裸写占位符
列名必须真实存在,拼错会报 Unknown column(运行时报,非配置校验时)
如果要实现“仅当新值非空才更新”,得在 EMQX 规则引擎里用 if 表达式预处理字段,不能靠 SQL 层判断
实际用起来最易忽略的点:它只响应**唯一性约束冲突**,不响应外键失败、NOT NULL 违反、类型转换错误等其它报错;一旦触发这些,整个语句直接失败,ON DUPLICATE KEY UPDATE 根本不执行。

