当前位置：首页 > 文章列表 > 数据库 > MySQL > MySQL ON DUPLICATE KEY UPDATE 为什么别再用 VALUES()：行别名改写和兼容边界

MySQL ON DUPLICATE KEY UPDATE 为什么别再用 VALUES()：行别名改写和兼容边界

来源：17golang原创 2026-07-18 12:53:05 0浏览收藏

库存同步服务升级数据库后，日志里开始出现一条容易被忽略的提示：ON DUPLICATE KEY UPDATE 里用 VALUES(stock) 读取待写入值的形式已被标记为弃用。业务没有马上出错，但这类提示如果长期搁着，后续升级时就会变成一批分散的 SQL 改造。

改法不是把 VALUES() 换成随便一个函数。MySQL 现在建议在 VALUES 或 SET 子句后给即将插入的行起别名，再通过这个别名读取新行字段。对单行或多行写入，这个迁移很直观；对 INSERT ... SELECT，则需要额外留意查询来源的别名。

要点速览：

VALUES(col) 在 ON DUPLICATE KEY UPDATE 中用于引用待插入行，但 MySQL 已将该用法标记为弃用。
普通 INSERT ... VALUES 可改为 AS new，例如 stock = new.stock。
INSERT ... SELECT 不能机械套行别名，应按来源列别名或派生表的写法改造。

先看旧写法：它解决了什么问题

以库存快照表为例，sku 有唯一索引。同步任务拿到最新库存后，希望不存在就插入，已存在就更新库存和同步时间。以前常见的写法是：

INSERT INTO inventory_snapshot (sku, stock, synced_at)
VALUES ('A-100', 16, '2026-07-18 12:00:00')
ON DUPLICATE KEY UPDATE
  stock = VALUES(stock),
  synced_at = VALUES(synced_at);

VALUES(stock) 这里并不是普通的 VALUES 语句，它表示“如果没有唯一键冲突，本来会写入 stock 列的值”。这让 upsert 能同时保留旧行的主键和新行的业务字段。

问题在于，这种在更新子句中引用新行字段的方式已经被 MySQL 标为弃用，并说明未来版本可能移除。这里不必等业务报错再动手：先把语义替换为行别名，改动范围最容易控制。

第 1 步：给待插入的行起别名

把 AS new 放在 VALUES (...) 后面，更新子句就能通过 new.列名 读取同一批待写入数据：

INSERT INTO inventory_snapshot (sku, stock, synced_at)
VALUES ('A-100', 16, '2026-07-18 12:00:00') AS new
ON DUPLICATE KEY UPDATE
  stock = new.stock,
  synced_at = new.synced_at;

这一步的判断很简单：new.stock 指新行准备写入的库存，inventory_snapshot.stock 指当前已有行的库存。两者都叫 stock 时，把新行放在 new 下，阅读 SQL 的人就不必猜字段来自哪里。

MySQL VALUES 函数弃用写法与 AS new 行别名写法在 upsert 中的修复对照 — 改造的核心是把“待插入行”的引用从 `VALUES()` 移到显式行别名。

第 2 步：多列写入时保持新旧字段的来源清楚

实际表往往不止更新一个字段。下面的写法把价格、库存、同步时间都来自新行，而 version 则基于旧行自增。这样的来源分工需要在 SQL 里直接看得出来：

INSERT INTO product_snapshot (sku, price, stock, synced_at, version)
VALUES ('A-100', 99.00, 16, '2026-07-18 12:00:00', 1) AS new
ON DUPLICATE KEY UPDATE
  price = new.price,
  stock = new.stock,
  synced_at = new.synced_at,
  version = product_snapshot.version + 1;

这里容易犯的错不是语法，而是语义：如果同步任务收到的是部分字段，直接用 new.字段 覆盖旧值，可能把本地维护的内容清掉。写入前先区分“外部快照覆盖列”“本地维护列”和“按旧值计算列”，再决定每个赋值表达式引用哪一边。

字段类型	推荐来源	示例
外部快照字段	新行别名	`stock = new.stock`
本地累计字段	已有行	`version = product_snapshot.version + 1`
需要保留旧值的可选字段	显式条件	`note = COALESCE(new.note, product_snapshot.note)`

第 3 步：列别名能更短，但行别名仍然要保留

MySQL 还允许为插入列起别名。这样更新子句可以写得更短，不过列别名仍要依附一个行别名：

INSERT INTO inventory_snapshot (sku, stock, synced_at)
VALUES ('A-100', 16, '2026-07-18 12:00:00') AS new(code, qty, fetched_at)
ON DUPLICATE KEY UPDATE
  stock = qty,
  synced_at = fetched_at;

短别名适合字段很多、语句较长的导入任务；普通业务 SQL 里，我更建议先用 new.stock 这种可读性更好的形式。无论选哪种，别名不能与表名冲突，同一行上的列别名也应保持唯一。

第 4 步：INSERT ... SELECT 不要机械替换

INSERT ... SELECT ... ON DUPLICATE KEY UPDATE 是另一条路径。官方文档指出，在这类语句的更新子句里使用 VALUES() 会产生警告；推荐做法是让 SELECT 的输出字段有可引用的名称，必要时包一层派生表。

INSERT INTO inventory_snapshot (sku, stock)
SELECT sku, stock
FROM (
  SELECT item_code AS sku, available_stock AS stock
  FROM supplier_snapshot
) AS src
ON DUPLICATE KEY UPDATE
  stock = src.stock;

这段 SQL 的重点不在“多套一层查询”，而在于 src.stock 的来源是明确的。改造前先确认原 SELECT 的输出列名；如果来自联合查询或表达式，也给它们稳定的别名，回归测试时才能一眼看出写入字段是否串位。