要成功搭建 MySQL Group Replication 集群,必须手动完成插件、网络、复制账号以及一致性参数的配置,任何一个环节缺失都可能导致集群无法正常运行。前置条件同样非常明确:MySQL 版本需满足 5.7.14+ 或 8.0+,同时启用 GTID 与 ROW 格式 binlog,配置唯一的 server_id,以及可被其他节点正常解析的 group_replication_local_address。此外,还要创建专用复制用户,并在创建过程中临时关闭 SQL_LOG_BIN。集群启动时,首个节点通过 bootstrap 完成初始化引导,后续节点再通过 seeds 加入集群,同时通信端口 33061 也必须提前放行。

Group Replication 并不是开箱即用的 MySQL 高可用功能,必须手动配置插件、网络连接、复制账户以及一致性相关参数。若直接使用默认配置启动,通常都会失败,甚至节点之间最基本的握手通信都无法通过。
确认 MySQL 版本与插件可用性
只有 MySQL 5.7.14+ 或 8.0+ 才支持 group_replication 插件,但不同次版本之间的行为差异较大,例如 8.0.23 之后会强制要求 binlog_checksum=NONE。因此在部署前建议先完成以下检查:
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'group_replication';—— 只有返回ACTIVE才说明插件已经成功加载SHOW VARIABLES LIKE 'version';用于确认当前版本不是 5.7.13 或更早版本,因为这些版本不支持该插件- 如果查询结果为空,需要先执行
INSTALL PLUGIN group_replication SONAME 'group_replication.so';,并确认插件路径与实际安装位置一致(例如/usr/lib/mysql/plugin/group_replication.so)
my.cnf 必须设置的 5 个关键项
以下配置是 MySQL Group Replication 部署中的关键参数,缺少任意一项,都可能导致节点无法加入复制组或频繁退出。尤其需要注意,server_id 与 group_replication_local_address 必须在全局范围内唯一,并且能够被其他节点正常解析,不能填写 localhost 或 127.0.0.1:
server_id = 1(每台服务器必须不同,例如依次设置为 2、3)gtid_mode = ON且enforce_gtid_consistency = ON(否则 Group Replication 插件会拒绝启动)binlog_format = ROW+log_bin = binlog+log_sla ve_updates = ONgroup_replication_group_name = "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"(所有节点必须完全一致,建议使用uuidgen生成唯一值)group_replication_local_address = "maria-01:33061"(主机名必须可解析且可被ping通,端口也不能被其他服务占用)
创建复制用户并关闭 SQL_LOG_BIN
在每个节点创建复制账号时,务必先临时关闭二进制日志,否则创建用户和授权操作可能被同步到其他节点,进一步引发循环复制、账号冲突或权限异常:
SET SQL_LOG_BIN = 0; CREATE USER 'rpl_user'@'%' IDENTIFIED BY 'StrongPass123!'; GRANT REPLICATION SLA VE ON *.* TO 'rpl_user'@'%'; FLUSH PRIVILEGES; SET SQL_LOG_BIN = 1; CHANGE MASTER TO MASTER_USER = 'rpl_user', MASTER_PASSWORD = 'StrongPass123!' FOR CHANNEL 'group_replication_recovery';
需要注意的是:MASTER_PASSWORD 在 MySQL 8.0.31+ 中已经被弃用,通常改为使用 MASTER_AUTO_POSITION = 1。不过对于 group_replication_recovery 通道,复制用户和认证信息仍然需要显式配置。
启动组时 bootstrap 只能执行一次
首次初始化 MySQL Group Replication 集群时,必须由第一个节点执行 group_replication_bootstrap_group = ON 来完成引导,其余节点都只能保持为 OFF。如果误将多个节点同时设置为引导模式,极有可能造成脑裂问题:
- 节点 1 启动前,先在配置文件中临时加入一行:
group_replication_bootstrap_group = ON - 启动 MySQL 服务后,连接实例并执行:
START GROUP_REPLICATION; - 检查状态:
SELECT * FROM performance_schema.replication_group_members;当显示为ONLINE后,应立即执行:SET GLOBAL group_replication_bootstrap_group = OFF; - 随后继续配置节点 2、3 并启动,它们会通过
group_replication_recovery通道从节点 1 自动拉取全量数据并加入集群
如果某个节点启动失败,长时间停留在 RECOVERING 状态,通常说明 group_replication_group_seeds 配置有误,或者防火墙没有放通 33061 端口。这个端口专门用于组内 Paxos 通信,与 MySQL 默认服务端口 3306 完全不同,不能混淆。
