MySQL 8.0复合主键场景下INSERT ON DUPLICATE KEY UPDATE执行失败

可能原因 #

• 参数绑定顺序错误：使用位置占位符（如?）时，若id和scenario的参数传递顺序与复合主键定义顺序相反，会导致插入的主键组合与现有数据重复。比如现有数据为(id='u1', scenario='u2')，但占位符绑定成(id='u2', scenario='u1')，此时INSERT触发主键冲突；而直接写实际值时顺序正确，因此正常执行。
• UUID参数类型不匹配：驱动或ORM未正确将UUID参数转换为MySQL的CHAR(36)类型。例如将Java的UUID对象直接传递，驱动错误转为二进制或32位无连字符字符串，导致数据库接收的主键值与预期不符。INSERT时数据库判定为新数据，但实际插入时与现有主键组合冲突；直接写字符串UUID则能被正确识别。
• 预编译语句缓存异常：MySQL预编译语句缓存中存在旧的错误语句定义，使用占位符执行时实际逻辑与预期不符；直接写实际值会生成新语句，绕过缓存因此正常执行。

解决办法 #

• 核对参数绑定顺序：确保占位符（如?）的参数传递顺序与复合主键(id, scenario)的定义顺序完全一致。比如JDBC中需按ps.setString(1, id)、ps.setString(2, scenario)的顺序绑定。
• 强制UUID以标准字符串传递：将UUID转换为36位带连字符的标准字符串（如xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）后再绑定占位符，避免驱动自动转换导致的格式错误。
• 清除预编译语句缓存：执行FLUSH PREPARED_STATEMENTS;清空MySQL的预编译语句缓存，重新执行带占位符的语句；若使用ORM框架，同步清空框架的语句缓存。
• 通过日志验证参数一致性：开启MySQL通用查询日志（SET GLOBAL general_log = ON;），对比带占位符和直接写实际值的语句，查看数据库接收的主键参数是否完全一致，定位参数传递问题。

内容的提问来源于stack exchange，提问作者Edward