如何在MySQL中实现高性能的批量Upsert操作_合并多个VALUES子句-SQL-PHP中文网

on duplicate key update必须依赖主键或唯一索引才能触发，否则退化为普通插入；需确保表中明确定义unique key或primary key，且values()严格绑定对应行字段值。

如何在mysql中实现高性能的批量upsert操作_合并多个values子句

MySQL批量Upsert必须依赖唯一约束才能触发ON DUPLICATE KEY

没有主键或唯一索引的表，INSERT ... ON DUPLICATE KEY UPDATE 会直接忽略冲突逻辑，变成普通插入——哪怕你写了ON DUPLICATE KEY UPDATE，也不会报错，但更新分支永远不执行。这是最常被忽略的前提。

常见错误是只加了普通索引（非UNIQUE）或误以为PRIMARY KEY自动覆盖所有字段。实际只要检查SHOW CREATE TABLE table_name输出里是否有UNIQUE KEY或PRIMARY KEY定义在你要匹配的列上即可。

单字段唯一：比如username设为UNIQUE，那用username值冲突才会触发UPDATE
组合唯一：如(user_id, action_type)需提前建UNIQUE KEY idx_user_action (user_id, action_type)
NULL值注意：唯一索引允许多行NULL，所以ON DUPLICATE KEY对NULL不生效，别拿它当“空值去重”用

VALUES子句必须合并成一条INSERT，不能拆成多条

MySQL的ON DUPLICATE KEY UPDATE只对**单条INSERT语句**生效。如果你把100条数据写成100个独立INSERT，就退化成100次单独判断+可能100次锁等待，性能断崖式下跌。

正确做法是用一个INSERT带多个VALUES元组，例如：

INSERT INTO users (id, name, email) VALUES
(1, 'Alice', 'a@example.com'),
(2, 'Bob', 'b@example.com'),
(3, 'Charlie', 'c@example.com')
ON DUPLICATE KEY UPDATE
  name = VALUES(name),
  email = VALUES(email);

这里VALUES(name)不是函数调用，而是MySQL内部语法糖，表示“本次VALUES列表中对应位置的name值”。它和VALUES子句严格位置绑定，不能跨行引用。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

字段顺序必须完全一致，否则VALUES(col)会取错值
每批建议≤500行：太长的SQL可能触发max_allowed_packet或解析超时
避免在VALUES里混用NULL和DEFAULT，显式写出更可控

MyBatis动态拼接时，VALUES括号不能漏、不能多嵌套

MyBatis的<foreach></foreach>容易在生成SQL时多加一层括号，导致语法错误。典型错误写法：VALUES (<foreach>(...)</foreach>)，结果变成VALUES ((...), (...))——外层多了一对括号，MySQL直接报错ERROR 1064。

正确模板是让<foreach></foreach>直接生成逗号分隔的元组，外面不额外包括号：

<insert id="batchUpsert" parametertype="list">
  INSERT INTO user_info (id, name, email) VALUES
  <foreach collection="list" item="item" separator=",">
    (#{item.id}, #{item.name}, #{item.email})
  </foreach>
  ON DUPLICATE KEY UPDATE
    name = VALUES(name),
    email = VALUES(email)
</insert>