MySQL Group Replication集群搭建步骤与配置指南

要成功搭建 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 = ON
• group_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 完全不同，不能混淆。