主从复制中AUTO_INCREMENT冲突的典型现象是Duplicate entry ‘X’ for key ‘PRIMARY’错误,根源在于误写从库或主从切换后未重置自增值;需配置auto_increment_increment和auto_increment_offset参数实现主从ID错开,切换后须手动校准AUTO_INCREMENT值,必要时可用UUID或雪花ID替代。
主从复制中 AUTO_INCREMENT 冲突的典型现象
主从复制下写入从库(比如误操作或双写),或者主库故障切从为主后未重置 AUTO_INCREMENT 值,会导致新插入记录的主键重复。常见错误是 Duplicate entry 'X' for key 'PRIMARY',尤其在应用未做唯一性兜底时直接报错中断。
必须设置的两个关键参数
MySQL 通过 auto_increment_increment 和 auto_increment_offset 控制自增步长与起始偏移,这是避免主从冲突最直接有效的手段。两者需成对配置,且在主从节点上取值不同:
- 主库设为:
auto_increment_increment = 2,auto_increment_offset = 1 - 从库(或另一主)设为:
auto_increment_increment = 2,auto_increment_offset = 2
这样主库生成 1、3、5…,从库生成 2、4、6…,互不重叠。注意:若部署多主(如双写架构),increment 应设为总节点数,offset 每节点唯一(1 到 N)。
切换主从后务必重置 AUTO_INCREMENT 值
从库提升为主库后,原主库可能已写入部分自增值,而新主库的 AUTO_INCREMENT 值仍沿用旧从库状态,极易与后续写入冲突。操作前必须手动校准: