主从切换后AUTO_INCREMENT值不一致会导致主键冲突，必须在切换前统一配置、校验并手动修正各节点的自增值，且GTID模式下仍需单独检查。
主从切换后
值不一致，直接导致写入冲突
MySQL 主从切换后，如果原主库和新主库的
和
配置没对齐，或者从库在提升为主库前没手动修正
值，新主库可能分配出已存在于旧主库（现从库）中的 ID，造成主键冲突。典型现象是应用报错：
。
必须在切换前确认所有节点的
一致；若使用双主或环形复制，
应设为大于等于节点数的值（如 2 节点设为 2），
各节点错开（如 1 和 2）
切换后立刻在新主库上执行
，再用
手动设为该最大值 +1 —— 注意这个 N 必须大于当前所有从库中该表的最大 ID
不要依赖
的
来判断“数据已追平”，它不反映自增 ID 分配状态；真正要查的是各节点上对应表的
mysql
d 启动时
不生效？检查配置加载顺序
MySQL 启动时若同时在命令行、
、
或运行时 SET 中设置了
，优先级会覆盖预期值。最常见情况是：配置文件写了
，但启动脚本里又加了
，结果以命令行为准。
用
查运行时实际值，不是看配置文件
和
必须成对设置，且
必须在 1 到
之间（含），否则 MySQL 启动时会静默重置为 1
动态 SET（如
）只对当前会话有效，不持久化，切勿用于主从一致性保障
GTID 模式下
冲突更隐蔽，但修复逻辑不变
开启 GTID 后，主从切换通常走
，看起来更可靠，但
仍完全独立于 GTID 管理——GTID 只保证事务不重复执行，不保证自增值不重复生成。
MySQL（Linux）
MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。
下载
即使
完全一致，也不能说明各节点的
值同步；必须单独校验
使用
备份时，如果源库
值偏高，恢复到新实例后会继承该值，但若未校准，可能和线上其他节点冲突
Percona Toolkit 的
不检查自增列值，它只比对行内容；要查 ID 分布，得自己写脚本遍历关键表的
从库提升为主库后，
可能跳过自增校验
当从库被提升为主库，且应用开始往它写入数据时，如果用了
这类语句，MySQL 不会校验生成的
是否已存在，也不会触发
机制——它只是普通值插入。一旦这个计算值撞上已有主键，就直接报错。
这种写法绕过了自增保护，本质上是业务逻辑缺陷，不能靠数据库参数修复
上线前应扫描代码中所有
、
、
，确认是否显式指定了主键值
临时补救：在新主库上给关键表加
索引（如果还没加），让冲突提前暴露；长期方案是改用
不带主键列，交由
分配
事情说清了就结束。自增值一致性从来不是“配置好就能自动同步”的事，它依赖人工校验、明确约定和持续监控——尤其是切换窗口期那几分钟，最容易被日志滚动盖过去。
AUTO_INCREMENTauto_increment_offsetauto_increment_incrementAUTO_INCREMENTDuplicate entry '12345' for key 'PRIMARY'show variables like 'auto_increment%';auto_increment_incrementauto_increment_offsetSELECT MAX(id) FROM table_name;ALTER TABLE table_name AUTO_INCREMENT = N;SHOW SLAVE STATUSExec_Master_Log_PosMAX(id)auto_increment_offsetmy.cnfmy.iniauto_increment_offsetauto_increment_offset = 2--auto-increment-offset=1mysql -e "SHOW VARIABLES LIKE 'auto_increment%';"auto_increment_offsetauto_increment_incrementoffsetincrementSET @@auto_increment_offset = 3;AUTO_INCREMENTCHANGE MASTER TO MASTER_AUTO_POSITION = 1AUTO_INCREMENTgtid_executedAUTO_INCREMENTmysqldump --set-gtid-purged=OFFAUTO_INCREMENTpt-table-checksumMAX(id)INSERT ... SELECTINSERT INTO t1 SELECT id+1000, ... FROM t2id+1000AUTO_INCREMENTINSERT ... SELECTREPLACEINSERT ... ON DUPLICATE KEY UPDATEUNIQUEINSERT ... SELECTAUTO_INCREMENT