必须先安装半同步插件（主库rpl_semi_sync_master或rpl_semi_sync_source，从库rpl_semi_sync_slave或rpl_semi_sync_replica），再配置启用参数并重启io线程，最后通过show status验证rpl_semi_sync_master_status和rpl_semi_sync_slave_status均为on才算真正启用。
MySQL 8.0 的半同步复制不是靠改几个配置就能启用的，必须先装插件、再启开关、最后验证状态；漏掉任一环节，Rpl_semi_sync_master_status 都会是 OFF，看起来配好了，实际仍是异步复制。
主库必须先装插件再设 enabled，否则 mysqld 启动失败
MySQL 8.0 默认不加载半同步插件，rpl_semi_sync_master_enabled = ON 这类配置项只有在插件已安装的前提下才被识别。如果只在 /etc/my.cnf.d/mysql-server.cnf 里写了这行就重启，mysqld 会直接退出，错误日志中出现类似 Unknown variable 'rpl_semi_sync_master_enabled' 的报错。
正确顺序是：
- 登录主库 MySQL，执行：
INSTALL PLUGIN rpl_semi_sync_master SONAME 'semisync_master.so';（MySQL 8.0.25 及以下）或INSTALL PLUGIN rpl_semi_sync_source SONAME 'semisync_source.so';（8.0.26+） - 确认安装成功：
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME LIKE '%semi%';，状态必须为ACTIVE - 再编辑配置文件，在
[mysqld]段添加：rpl_semi_sync_master_enabled = ON和rpl_semi_sync_master_timeout = 3000（单位毫秒，不建议设为 0）
从库装插件后必须重启 IO 线程，否则状态永远 OFF
Rpl_semi_sync_slave_status 显示 OFF 是最常见假成功现象。根本原因不是插件没装，而是从库的 IO 线程启动时没加载半同步逻辑——仅执行 SET GLOBAL rpl_semi_sync_slave_enabled = 1 不触发初始化。
必须显式重启 IO 线程：
- 执行：
STOP SLAVE IO_THREAD;→START SLAVE IO_THREAD; - 检查
SELECT @@plugin_dir;，确认semisync_slave.so（≤8.0.25）或semisync_replica.so（≥8.0.26）真实存在且路径正确 - 从库配置中还必须包含：
server-id（不能和主库重复）、relay-log（如relay-log = relay-bin）、read_only = ON（防止误写破坏 GTID 或数据一致性）
超时值和 wait_point 决定“崩溃后能否找回已提交事务”
rpl_semi_sync_master_timeout 不只是性能参数，它直接影响数据丢失边界：设太小（如 100ms），网络抖动就频繁降级为异步；设太大（如 60000ms），主库写入会被卡住，业务直接受影响。
更关键的是 rpl_semi_sync_source_wait_point（8.0.26+）或旧版 rpl_semi_sync_master_wait_point：
-
AFTER_SYNC（推荐）：主库写完 binlog → 等 ACK → 再提交。主库崩溃后，所有已提交事务一定存在于至少一个从库的 relay log 中 -
AFTER_COMMIT：主库先提交 → 再等 ACK。崩溃时，已提交但未发出去的事务会丢失 - 务必执行：
SET GLOBAL rpl_semi_sync_source_wait_point = 'AFTER_SYNC';（该设置对后续事务生效）
真正启用的唯一判断依据是运行时状态，不是配置文件或变量值。主库上执行 SHOW STATUS LIKE 'Rpl_semi_sync%';，必须看到 Rpl_semi_sync_master_status 和 Rpl_semi_sync_slave_status 均为 ON，且 Rpl_semi_sync_master_clients > 0；任何一环依赖手动命令（装插件、启线程、设 wait_point），都不可省略或用配置替代。
