如何配置MySQL半同步主从复制-mysql教程-PHP中文网

半同步复制需先手动安装插件才能启用，否则配置无效；主库超时参数决定降级行为，时间不同步会导致频繁降级；判断是否生效应查rpl_semi_sync_master_status等状态变量而非seconds_behind_master。

如何配置mysql半同步主从复制

半同步复制插件必须手动安装，不能只靠配置文件启用

MySQL默认不加载半同步插件，rpl_semi_sync_master_enabled 和 rpl_semi_sync_slave_enabled 这两个变量初始值都是 OFF，即使你在 my.cnf 里写了 rpl-semi-sync-master-enabled = 1，重启后也不会生效——因为插件根本没装。

必须先在主库和从库分别执行 INSTALL PLUGIN 命令：

mysql> INSTALL PLUGIN rpl_semi_sync_master SONAME 'semisync_master.so';
mysql> INSTALL PLUGIN rpl_semi_sync_slave SONAME 'semisync_slave.so';

注意点：

semisync_master.so 和 semisync_slave.so 文件路径因 MySQL 版本和安装方式而异，常见位置是 /usr/lib/mysql/plugin/ 或 /usr/local/mysql/lib/plugin/；找不到时用 find / -name "semisync*.so" 2>/dev/null 搜
插件安装后会写入系统表 mysql.plugin，下次启动自动加载，但首次必须显式安装
MySQL 8.0.23+ 开始支持动态加载插件，无需重启，但旧版本（如 5.7）建议安装后重启 mysqld 以确保稳定

主库超时参数 `rpl_semi_sync_master_timeout` 决定降级行为

半同步不是“永远等”，它有兜底机制：主库提交事务后，若在 rpl_semi_sync_master_timeout 毫秒内没收到从库确认，就自动切回异步模式，避免业务阻塞。这个值默认是 10000（10 秒），但实际生产中常设为 1000～3000。

关键影响：

设太高（比如 30000）：网络抖动时主库长时间卡住，应用写入延迟飙升
设太低（比如 100）：轻微延迟就降级，半同步形同虚设
rpl_semi_sync_master_wait_no_slave 设为 ON（默认）时，即使当前没从库在线，主库也坚持等待；设为 OFF 则只要无可用从库，直接走异步

推荐命令一次性设置：

mysql> SET GLOBAL rpl_semi_sync_master_enabled = ON;
mysql> SET GLOBAL rpl_semi_sync_master_timeout = 2000;
mysql> SET GLOBAL rpl_semi_sync_master_wait_no_slave = OFF;

`SHOW SLAVE STATUS` 里的 `Seconds_Behind_Master` 不代表半同步状态

很多人误以为 Seconds_Behind_Master = 0 就说明半同步正常，其实不是。这个字段只反映 SQL 线程重放 relay log 的延迟，和 IO 线程是否收到 binlog、是否触发半同步确认完全无关。

MySQL

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

下载

真正判断半同步是否生效，要看这两个变量：

主库执行：SHOW GLOBAL VARIABLES LIKE 'rpl_semi_sync_master_status'; → 返回 ON 才表示当前处于半同步模式（不是“已启用”，而是“正在运行”）
从库执行：SHOW GLOBAL VARIABLES LIKE 'rpl_semi_sync_slave_status'; → 同样需为 ON
主库执行：SHOW GLOBAL STATUS LIKE 'Rpl_semi_sync_master_clients'; → 显示当前有多少个从库已注册为半同步客户端（注意：不是连接数，是成功握手并开启半同步的从库数）

如果 Rpl_semi_sync_master_clients 是 0，但从库 rpl_semi_sync_slave_status 是 ON，大概率是主库没收到从库的 ACK —— 检查防火墙、网络连通性、或从库是否真的完成了 START SLAVE（半同步依赖 IO 线程运行）

时间不同步会导致半同步反复降级

半同步依赖主从之间的时间感知：主库发日志、从库写 relay log、主库等待 ACK，整个链路对时间差敏感。如果主从服务器时间偏差超过几秒，可能引发超时误判、ACK 丢弃、甚至 Seconds_Behind_Master 报负值。

必须统一时间源：

所有节点都用 ntpdate 或 chronyd 同步到同一 NTP 服务器（如 ntp.aliyun.com 或内网 NTP 服务）
不要只同步一次，要配置定时任务，例如：*/5 * * * * /usr/bin/ntpdate ntp.aliyun.com > /dev/null 2>&1
检查时间差：ntpq -p 或 timedatectl status，确保 offset 在 ±100ms 内

曾经有案例：主库时间快 3 秒，从库慢 2 秒，合计偏差 5 秒，导致 rpl_semi_sync_master_timeout=2000 实际等不到 ACK，每笔事务都降级。调准时间后立刻恢复正常。

半同步的可靠性不只靠参数，更依赖主从间基础协同——插件、网络、时间，三者缺一不可。任一环节松动，它就悄悄退化成异步，而你可能还在监控里看 Slave_IO_Running: Yes 就放心了。