半同步复制需先手动安装插件才能启用，否则配置无效；主库超时参数决定降级行为，时间不同步会导致频繁降级；判断是否生效应查rpl_semi_sync_master_status等状态变量而非Seconds_Behind_Master。
半同步复制插件必须手动安装，不能只靠配置文件启用
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、是否触发半同步确认完全无关。
真正判断半同步是否生效，要看这两个变量：
- 主库执行：
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 就放心了。
