怎样在MySQL 8.0中启用双向半同步复制的相关配置参数-mysql教程-PHP中文网

mysql 8.0 不支持“双向半同步复制”这一内置模式，本质是两套独立主从链路（a→b 和 b→a），每条需分别配置并启用半同步（rpl_semi_sync_source_enabled 和 rpl_semi_sync_replica_enabled），插件名在 8.0.26+ 已更新为 semisync_source.so/semisync_replica.so，且必须显式设 replicate-same-server-id=0、错开 auto_increment_offset/ increment、双向开放网络并清空旧 gtid 状态。

怎样在mysql 8.0中启用双向半同步复制的相关配置参数

MySQL 8.0 不支持“双向半同步复制”这个概念——它没有内置的双向半同步模式。所谓“双向”，本质是两套独立的主从链路（A→B 和 B→A），每条链路可单独启用半同步；但必须分别配置、分别验证，不能靠一个开关统一控制。

为什么不能直接配“双向半同步”

MySQL 的半同步插件（rpl_semi_sync_source / rpl_semi_sync_replica）只作用于单向复制流：主库发、从库收。A 把自己当主库配半同步，只管 A→B 这一跳是否收到确认；B 同样只管 B→A 这一跳。两者完全解耦，没有协调机制。

常见误解包括：

以为在双主配置里加一句 rpl_semi_sync_master_enabled = ON 就自动双向生效
误认为 MASTER_AUTO_POSITION = 1 能让半同步状态跨方向同步
忽略插件名在 8.0.26+ 已变更（rpl_semi_sync_master → rpl_semi_sync_source）

两套链路各自启用半同步的关键参数

每台机器既要作为 source（主），也要作为 replica（从），所以配置文件中必须同时包含 source 和 replica 的半同步开关，且插件必须分别安装：

主库角色（即对外提供 binlog 的角色）需启用：rpl_semi_sync_source_enabled = ON + rpl_semi_sync_source_timeout = 3000
从库角色（即接收并应用 relay log 的角色）需启用：rpl_semi_sync_replica_enabled = ON
两者必须共存于同一配置段（[mysqld]），不可拆开
rpl_semi_sync_source_timeout 单位是毫秒，设为 0 会阻塞写入直到从库响应，生产环境禁用

示例（Node A 的 /etc/my.cnf.d/mysql-server.cnf）：

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

[mysqld]
server-id = 1
log-bin = mysql-bin
binlog-format = ROW
gtid_mode = ON
enforce_gtid_consistency = ON
log_slave_updates = ON
<h1>半同步：A 作为 source（被 B 拉取时生效）</h1><p>rpl_semi_sync_source_enabled = ON
rpl_semi_sync_source_timeout = 3000</p><h1>半同步：A 作为 replica（拉取 B 的数据时生效）</h1><p>rpl_semi_sync_replica_enabled = ON</p>

插件安装顺序和版本适配

MySQL 8.0.26 起，半同步插件名已更新，旧名（rpl_semi_sync_master）不再识别。不按版本装对插件，SHOW STATUS LIKE 'Rpl_semi%' 永远返回空或 OFF：

8.0.26 及之后版本：Node A 执行 INSTALL PLUGIN rpl_semi_sync_source SONAME 'semisync_source.so';
同版本下 Node A 作为 replica 时：执行 INSTALL PLUGIN rpl_semi_sync_replica SONAME 'semisync_replica.so';
装完必须重启 mysqld，且重启后需在 SQL 中再次执行 SET GLOBAL rpl_semi_sync_source_enabled = ON;（my.cnf 配置仅启动时读取一次）
验证是否真启用：SHOW STATUS LIKE 'Rpl_semi_sync_source_status'; 返回 ON 才算成功，仅查变量值（@@rpl_semi_sync_source_enabled）没用

容易被忽略的冲突点

即使参数全对、插件全装，双向半同步仍可能“看起来通、实际失效”，关键卡点在：

replicate-same-server-id = 0 必须显式配置——否则 B 收到 A 的事件后可能又转发回 A，导致半同步确认混乱甚至死循环
两端的 auto_increment_offset 和 auto_increment_increment 必须错开（如 A: offset=1, inc=2；B: offset=2, inc=2），否则 INSERT 不指定 ID 时两边都生成 ID=1，复制中断并报 Duplicate entry '1' for key 'PRIMARY'
网络必须双向开放 3306，且防火墙/SELinux 不拦截 repl 用户连接（mysqld_can_network_connect 需为 on）
GTID 模式下，CHANGE MASTER TO 必须带 MASTER_AUTO_POSITION = 1；若之前用过传统模式，务必先 RESET SLAVE ALL; 清状态，否则 Retrieved_Gtid_Set 为空，半同步根本不会触发