ON DUPLICATE KEY UPDATE 仅更新显式指定的列,未列出的列保持原值;VALUES(col) 引用 INSERT 中对应值,安全防注入;多唯一键易致更新不确定,EMQX 中占位符仅限 VALUES() 内使用。

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。
- 必须和
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。这意味着:如果多行同时匹配,只更新其中一行,顺序不确定。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
容易踩的坑: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 拦截。
正确写法: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 根本不执行。










