SQL Group Replication 的 auto-increment-increment 设置避免冲突

所有 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 场景下必须镜像，少一个，写操作就随时可能崩。