所有mysql group replication节点的auto_increment_increment必须统一设为7(与group_replication_auto_increment_increment一致),否则会导致主键冲突、事务失败或组退出;该值须在my.cnf中静态配置并重启生效,运行时set global无效。

MySQL Group Replication 节点间 auto_increment_increment 必须统一
多个节点各自设不同 auto_increment_increment 值,会导致主键冲突、事务回滚甚至整个组退出。Group Replication 不依赖该变量做分片逻辑,它只靠 group_replication_auto_increment_increment(内部专用)协调,所以外部手动调 auto_increment_increment 不但无效,反而危险。
- 所有节点必须设为相同值,官方推荐
7(与默认group_replication_auto_increment_increment一致),不能是1 - 修改必须在
my.cnf中静态配置,启动前写死;运行时用SET GLOBAL修改会被 GR 忽略,且重启后丢失 - 如果已有节点设了
1,新加节点设7,插入会因自增步长不一致触发ER_AUTOINC_READ_FAILED或隐式锁等待超时
为什么不能靠 auto_increment_offset 实现“分片式”插入
有人想让节点 A 插 1,8,15...、节点 B 插 2,9,16...,这是对单主模式的惯性思维。Group Replication 是多主(multi-primary)或单主(single-primary)均可,但无论哪种,所有写入都经由组内共识协议广播,不是本地生成就完事——自增 ID 在 apply 阶段才真正分配,且由 coordinator 统一调度。
-
auto_increment_offset在 GR 中完全无作用;设了也不会被读取,GR 自己用group_replication_auto_increment_offset控制内部偏移 - 强行设置不同
offset可能导致某节点在本地执行 INSERT 后,apply 到其他节点时发现 ID 已存在,报错ERROR 1062 (23000): Duplicate entry 'X' for key 'PRIMARY' - 这种错误不会自动重试,事务直接失败,应用层看到的是非预期的主键冲突,而非连接或同步问题
检查和修复已存在的 auto_increment_increment 不一致
用 SHOW VARIABLES LIKE 'auto_increment%'; 查每个节点,重点看 auto_increment_increment 是否全等。不一致必须停写、逐节点改配置、重启 mysqld。
- 确认当前值:
SELECT @@auto_increment_increment;(注意是 session 级,要加GLOBAL才准:SELECT @@global.auto_increment_increment;) - 临时改(仅测试用):
SET GLOBAL auto_increment_increment = 7;,但 GR 启动后可能覆盖,不能替代配置文件 - 生产环境必须改
/etc/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf,在[mysqld]下加:auto_increment_increment = 7 - 改完不要只 reload,必须
systemctl restart mysql,否则 GR 初始化阶段仍读旧值
group_replication_auto_increment_increment 和 auto_increment_increment 的关系
前者是 GR 插件自己用的内部参数,默认 7,不可改;后者是 MySQL Server 层变量,GR 要求它和前者一致,否则启动时报 ERROR 3092 (HY000): The server is not configured properly to join the group。
-
group_replication_auto_increment_increment是只读变量,SHOW VARIABLES 里能看到,但 SET 会报错 - 如果你看到 ERROR 3092,第一反应不是查网络或证书,先查
@@global.auto_increment_increment是否等于7 - MySQL 8.0.27+ 对这个校验更严格:即使节点已加入组,后续改
auto_increment_increment到非匹配值,再执行 DML 就可能触发ER_GRP_RPL_AUTO_INC_CONFLICT
group_replication_auto_increment_increment 就够了,结果忘了同步改 auto_increment_increment——这两个值在 GR 场景下必须镜像,少一个,写操作就随时可能崩。










