ON DUPLICATE KEY UPDATE未触发更新的最常见原因是目标字段未建UNIQUE或PRIMARY KEY索引，MySQL仅依据物理唯一约束判断冲突，不感知业务语义，无索引则直接执行普通INSERT。
能用 ON DUPLICATE KEY UPDATE 就别先查再插/再更新 —— 它一条 SQL 完成判断+写入，但前提是唯一约束必须生效，否则直接变普通 INSERT，冲突也不更新。
MySQL 中 ON DUPLICATE KEY UPDATE 为什么没触发更新？
最常见原因是：目标字段上没建 UNIQUE 或 PRIMARY KEY 索引。MySQL 不会主动“猜”你拿哪几个字段去判重，它只看索引定义。
- 只建了普通
INDEX（非唯一）？不生效 - 联合唯一索引是
UNIQUE (tenant_id, external_id)，但INSERT语句里只给了external_id？无法匹配冲突，跳过UPDATE分支 - 字段类型隐式转换导致索引失效（比如
VARCHAR字段存了带空格的值，而查询时没 trim） - 执行后
mysqli_affected_rows()返回 1 而不是 2？说明根本没走更新分支，优先检查索引和 VALUES 是否覆盖全部冲突字段
PHP 拼接 ON DUPLICATE KEY UPDATE 的安全写法
手拼 SQL 时最容易在转义和类型上翻车，尤其当数据来自用户输入或数组循环。
- 数值型字段（如
id,sort_order）用intval()或(int)强制转换，不要加引号 - 字符串字段必须用
mysqli_real_escape_string()（或更推荐：PDO 预处理）—— 直接拼接"'{$str}'"是 SQL 注入温床 -
VALUES(column_name)是 MySQL 内置函数，表示本次INSERT中该列的值，不是 PHP 变量；写成nickname=VALUES(nickname)才对，别写成nickname=$nickname - 批量插入多行时，
VALUES后跟多个元组：VALUES (1,'a'),(2,'b') ON DUPLICATE KEY UPDATE ...，注意括号层级和逗号分隔
Laravel 的 upsert() 和原生 ON DUPLICATE KEY UPDATE 什么关系？
upsert() 是 Laravel 9.2+ 对底层数据库语法的封装，它生成的 SQL 就是 ON DUPLICATE KEY UPDATE（MySQL）或 ON CONFLICT ... DO UPDATE（PostgreSQL），不是模拟逻辑。
立即学习“PHP免费学习笔记（深入）”；
- Laravel 8 及以下调用
upsert()会抛BadMethodCallException，不能回退到 foreach + save() - 它要求你显式传入
$uniqueBy参数（如['email']），这个数组必须与数据库中实际生效的唯一索引字段完全一致，否则生成的 SQL 会报错或行为异常 - 不支持在
upsert()中做字段自增（如login_count = login_count + 1），因为它是基于VALUES()函数的，只能设为新值；要自增得回退到原生 SQL 或使用updateOrInsert()
并发场景下 ON DUPLICATE KEY UPDATE 的原子性边界在哪？
它确实是原子操作，但“原子”的范围仅限于单条语句执行过程：MySQL 会对冲突涉及的索引记录加锁，防止其他事务同时修改同一行。但要注意这些边界：
- 锁是行级的，不是表级，不影响无关记录的写入
- 如果冲突发生在联合唯一索引上，且两个事务分别插入
(1,'a')和(1,'b')，它们可能锁住不同行，不会互相阻塞；但如果都试图插入(1,'a')，就会排队 - 没有事务包裹时，它自己就是最小事务单元；但如果你在事务里执行多条
upsert，失败仍会回滚整个事务 - 别指望它解决“读-改-写”类业务逻辑（比如先查余额再扣减），它只适合“有则更新、无则插入”这种幂等写入
真正容易被忽略的是：所有数据库层的 upsert 都依赖索引定义与 SQL 语句的一致性。索引建错、字段漏写、类型不匹配 —— 这些问题不会报语法错误，而是静默降级为普通插入，线上出问题时极难排查。
