Docker环境下MySQL InnoDB集群Group Replication异常及relay-log警告排查求助

一、先消除relay-log警告（排除干扰项） #

你看到的警告并非relay_log变量未配置，而是MySQL启动时未通过命令行或配置文件显式指定该参数，启动后MySQL自动用容器主机名生成了relay-log文件名，因此触发警告。解决方法：

• 方式1：启动容器时显式指定参数
  运行Docker容器时，将--relay-log参数加入启动命令：

  docker run -d \
    --name mysql-node1 \
    --network mysql-cluster-net \
    -e MYSQL_ROOT_PASSWORD=xxx \
    mysql:8.0 \
    mysqld --relay-log=f3353ca0124a-relay-bin \
           --group_replication_group_name="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" \
           --group_replication_local_address="node1:33061" \
           --group_replication_group_seeds="node1:33061,node2:33061,node3:33061" \
           --group_replication_start_on_boot=ON
  

• 方式2：挂载自定义配置文件
  创建my.cnf文件，添加以下配置：

  [mysqld]
  relay-log = f3353ca0124a-relay-bin
  # 其他Group Replication配置...
  

  启动容器时挂载该文件：

  docker run -d \
    --name mysql-node1 \
    --network mysql-cluster-net \
    -v /path/to/your/my.cnf:/etc/mysql/my.cnf \
    -e MYSQL_ROOT_PASSWORD=xxx \
    mysql:8.0
  

二、排查Group Replication未激活的核心问题 #

relay-log警告大概率不是Group Replication未激活的直接原因，需重点检查以下内容：

1. 验证Group Replication核心配置一致性 #

在每个节点执行以下查询，确保所有节点配置一致（仅group_replication_local_address需唯一）：

SHOW VARIABLES LIKE '%group_replication%';

需重点确认：

• group_replication_group_name：所有节点必须是同一个合法UUID（可通过SELECT UUID();生成）
• group_replication_local_address：每个节点的唯一通信地址（格式：容器名/IP:33061）
• group_replication_group_seeds：包含所有节点的通信地址，格式如node1:33061,node2:33061,node3:33061
• gtid_mode：必须设置为ON（Group Replication依赖GTID）
• group_replication_start_on_boot：设置为ON确保容器重启后自动加入集群

2. 检查节点网络连通性 #

Docker环境中，集群节点必须在同一个自定义网络内，且能互相访问3306（SQL端口）和33061（Group Replication通信端口）：

• 进入容器测试连通性：

  docker exec -it mysql-node1 ping mysql-node2
  docker exec -it mysql-node1 telnet mysql-node2 33061
  

  若连通失败，需检查Docker网络配置，确保节点都加入同一个网络。

3. 查看Group Replication集群状态 #

在任意节点执行以下查询，确认节点状态：

SELECT * FROM performance_schema.replication_group_members;

正常状态下，所有节点的MEMBER_STATE应为ONLINE，若出现UNREACHABLE或ERROR，需对应排查该节点的配置或网络。

另外，查看集群状态变量：

SHOW STATUS LIKE '%group_replication%';

重点关注group_replication_member_state（应为ONLINE）和group_replication_primary_member（单主模式下显示主节点UUID）。

4. 检查错误日志中的Group Replication相关报错 #

除了relay-log警告，错误日志中可能存在Group Replication的具体故障信息，比如：

• UUID冲突
• GTID集合不一致
• 复制账号权限不足
• 节点初始化数据不一致

可通过以下命令查看容器内的错误日志：

docker logs mysql-node1

5. 验证复制账号权限 #

确保用于Group Replication的账号拥有足够权限：

GRANT REPLICATION SLAVE, REPLICATION CLIENT, GROUP_REPLICATION_ADMIN ON *.* TO 'repl'@'%';
FLUSH PRIVILEGES;

内容的提问来源于stack exchange，提问作者eedideyahoocom